動的セッション記録
以前は、セッション記録は、記録ポリシーに合致するセッションの開始時に厳密に開始され、それらのセッションが終了すると厳密に停止していました。
7.18リリース以降、Citrixは動的セッション記録機能を導入しました。この機能を使用すると、特定のセッション、または特定のユーザーが起動するセッションの記録を、セッション中にいつでも開始または停止できます。
注：
この機能が期待どおりに動作するようにするには、Session Recording、VDA、およびDelivery Controllerをバージョン7.18以降にアップグレードしてください。
動的セッション記録の有効化または無効化
Session Recording Agentでは、この機能を有効または無効にするためのレジストリ値が追加されます。このレジストリ値はデフォルトで1に設定されており、これは、この機能がデフォルトで有効になっていることを意味します。
この機能を有効または無効にするには、次の手順を実行します。
- Session Recordingのインストールが完了したら、Session Recording Agentをインストールしたマシンに管理者としてログオンします。
- レジストリエディターを開きます。
-
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditorに移動します。 - DynamicControlAllowedの値を0に設定するか、デフォルト値の1を使用します。 1：動的記録を有効にする 0：動的記録を無効にする
- 設定を有効にするには、Session Recording Agentを再起動します。 展開にMCSまたはPVSを使用している場合は、マスターイメージで設定を変更し、更新を実行して変更を有効にします。
警告：
レジストリを誤って編集すると、オペレーティングシステムの再インストールが必要になるような深刻な問題が発生する可能性があります。Citrix®は、レジストリエディターの誤った使用によって発生した問題が解決されることを保証できません。レジストリエディターは自己責任で使用してください。編集する前に必ずレジストリをバックアップしてください。
Citrix Broker SDK の PowerShell コマンドを使用して、動的に録画を開始または停止する
動的セッション記録機能向けにCitrix Broker SDKへ追加された3つのPowerShellコマンドを、以下の表に記載しています。Citrix Broker SDKに関する詳細情報については、Citrix SDKs and APIsおよびCitrix Virtual Apps and Desktops SDKをご参照ください。
| コマンド | 説明文 |
|---|---|
| Start-BrokerSessionRecording | 特定の有効なセッション、有効なセッションのリスト、または特定のユーザーによって起動されたセッションの録画を開始できます。詳細については、Get-Help Start-BrokerSessionRecording を実行してコマンドのオンラインヘルプを参照してください。 |
| Stop-BrokerSessionRecording | 特定の有効なセッション、有効なセッションのリスト、または特定のユーザーによって起動されたセッションの録画を停止できます。詳細については、Get-Help Stop-BrokerSessionRecording を実行してコマンドのオンラインヘルプを参照してください。 |
| Get-BrokerSessionRecordingStatus | 特定の有効なセッションの録画ステータスを取得できます。詳細については、Get-Help Get-BrokerSessionRecordingStatus を実行してコマンドのオンラインヘルプを参照してください。 |
たとえば、ユーザーが問題を報告し、タイムリーなサポートが必要な場合、この機能を使用してユーザーの有効なセッションの録画を動的に開始し、ライブ録画を再生してその後のトラブルシューティングを進めることができます。次のことができます。
-
Citrix Studio コンソールからパワーシェルを起動します。
-
Get-BrokerSessionコマンドを使用して、ターゲットユーザーのすべての有効なセッションを取得します。
-
指定されたセッションの録画ステータスを取得するには、
Get-BrokerSessionRecordingStatusコマンドを使用します。
注：
-Session パラメーターは、一度に1つのセッションUidのみを受け入れます。
-
録画を開始するには、
Start-BrokerSessionRecordingコマンドを使用します。デフォルトでは、録画アクティビティをユーザーに通知するメッセージが表示されます。次の表は、
Start-BrokerSessionRecordingコマンドの一般的な使用方法を示しています。コマンド 説明文 Start-BrokerSessionRecording -User DomainA \ UserA DomainAという名前のドメイン内のユーザーUserAのすべてのセッションの録画を開始し、UserAに通知します。 Start-BrokerSessionRecording -User DomainA \ UserA -NotifyUser $false DomainAという名前のドメイン内のユーザーUserAのすべてのセッションの録画を開始し、UserAに通知しません。 Start-BrokerSessionRecording -Sessions $SessionObject $SessionObjectという名前のオブジェクト内のすべてのセッションの録画を開始し、ユーザーに通知します。$SessionObjectオブジェクトを取得するには、 $SessionObject=Get-BrokerSession –username UserAを実行します。オブジェクトの名前にはドル記号 $ がプレフィックスとして付きます。詳細については、手順2とコマンドのオンラインヘルプを参照してください。Start-BrokerSessionRecording -Sessions uid1,uid2,…,uidn セッション uid1, uid2, … , および uidn の記録を開始し、ユーザーに通知します。 -
各ターゲットセッションの記録ステータスを取得するには、
Get-BrokerSessionRecordingStatusコマンドを使用します。ステータスは SessionBeingRecorded であるはずです。 -
Session Recording Player で Live または Complete の記録を再生し、その後のトラブルシューティングに進みます。
注：
Stop-BrokerSessionRecordingコマンドによって終了された「Complete」記録を再生し、記録されたセッションの最後のセクションがアイドル状態の場合、Player のプログレスバーのタイムラインの最後のセクションが灰色で表示されることがあります。記録されたセッションに継続的なアクティビティがある場合は、これは明らかではありません。 -
報告された問題がトリアージまたは解決されたら、
Stop-BrokerSessionRecordingコマンドを使用して記録を停止します。次の表は、このコマンドの一般的な使用方法を示しています。
コマンド Description Stop-BrokerSessionRecording -User DomainA \ UserA DomainA という名前のドメイン内のユーザー UserA のすべてのセッションの記録を停止します。 Stop-BrokerSessionRecording -Sessions $SessionObject $SessionObject 内のすべてのセッションの記録を停止します。 Stop-BrokerSessionRecording -Sessions uid1,uid2,…,uidn セッション uid1, uid2, … , および uidn の記録を停止します。
Citrix Studioのログ画面で、Start-BrokerSessionRecordingおよびStop-BrokerSessionRecordingコマンドの結果ログを表示できます。
