動的セッション記録

以前は、セッション記録は、記録ポリシーを満たすセッションの開始時に厳密に開始され、それらのセッションが終了すると厳密に停止していました。

7.18リリース以降、Citrixは動的セッション記録機能を導入しました。この機能により、特定のセッションまたは特定のユーザーが起動するセッションの記録を、セッション中にいつでも開始または停止できます。

注：

この機能が期待どおりに動作するようにするには、Session Recording、VDA、およびDelivery Controllerをバージョン7.18以降にアップグレードしてください。

動的セッション記録を有効または無効にする

Session Recordingエージェントには、この機能を有効または無効にするためのレジストリ値が追加されています。このレジストリ値はデフォルトで1に設定されており、これは機能がデフォルトで有効になっていることを意味します。

この機能を有効または無効にするには、次の手順を実行します。

1. Session Recordingのインストールが完了したら、Session Recordingエージェントをインストールしたマシンに管理者としてログオンします。
2. レジストリエディターを開きます。
3. HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditorに移動します。
4. DynamicControlAllowedの値を0に設定するか、デフォルト値の1を使用します。 1: 動的記録を有効にする 0: 動的記録を無効にする
5. 設定を有効にするには、Session Recordingエージェントを再起動します。 MCSまたはPVSを使用して展開している場合は、マスターイメージの設定を変更し、更新を実行して変更を有効にします。

警告：

レジストリを誤って編集すると、オペレーティングシステムの再インストールが必要になるような深刻な問題が発生する可能性があります。Citrix®は、レジストリエディターの誤った使用によって生じる問題が解決できることを保証できません。レジストリエディターは自己責任で使用してください。編集する前に必ずレジストリをバックアップしてください。

Citrix SDKのPowerShellコマンドを使用して、動的に録画を開始または停止する

You can use the dynamic session recording feature in both on-premises and Citrix Cloud environments. To use the feature in an on-premises environment, use the Citrix Virtual Apps and Desktops™ PowerShell SDK. To use the feature in a Citrix Cloud environment, use the Citrix DaaS Remote PowerShell SDK (formerly Citrix Virtual Apps and Desktops Remote PowerShell SDK).

インストールして使用するSDKを決定するには、録画ポリシーの作成時に指定したDelivery Controller™に注意してください。Citrix Cloud環境でセッションを録画するためにCitrix Cloud Controllerチェックボックスを選択した場合は、Citrix Cloudの資格情報を検証する必要があります。

コントローラーへのクエリを作成(/ja-jp/session-recording/2509/media/create-query-to-ddc.png)

注：

Do not install the Citrix DaaS Remote PowerShell SDK on a Citrix Cloud Connector™ machine. You can install the Remote PowerShell SDK on any domain-joined machine within the same resource location. We recommend that you do not run this SDK’s cmdlets on Cloud Connectors. The SDK’s operation does not involve the Cloud Connectors.

次の表に、両方のCitrix SDKが動的セッション録画用に提供する3つのPowerShellコマンドを示します。

例えば、ユーザーが問題を報告し、タイムリーなサポートが必要な場合、この機能を使用してユーザーのアクティブなセッションの記録を動的に開始できます。ライブ記録を再生して、その後のトラブルシューティングを進めることができます。実行できる操作は次のとおりです。

1. (シトリックス バーチャル アップス アンド デスクトップス パワーシェル SDKのみ) シトリックス スタジオ コンソールからパワーシェルを起動します。

   パワーシェルを起動する(/ja-jp/session-recording/2509/media/launch-powershell.jpg)

2. Get-BrokerSessionコマンドを使用して、ターゲットユーザーのすべてのアクティブなセッションを取得します。

   ゲット ブローカー セッションを実行する(/ja-jp/session-recording/2509/media/run-get-broker-session.png)

3. Get-BrokerSessionRecordingStatusコマンドを使用して、指定されたセッションの記録ステータスを取得します。

   セッションステータス取得コマンドを実行する(/ja-jp/session-recording/2509/media/run-get-session-status.png)

   注：

   -Sessionパラメーターは、一度に1つのセッションUIDのみを受け入れます。

4. 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のセッションの記録を開始し、ユーザーに通知します。

5. Get-BrokerSessionRecordingStatusコマンドを使用して、各ターゲットセッションの記録ステータスを取得します。ステータスはSessionBeingRecordedである必要があります。

6. 記録を再生し、その後のトラブルシューティングに進みます。

   注：

   Stop-BrokerSessionRecordingコマンドによって終了した完了した記録をSession Recording Playerで再生すると、プレーヤーのプログレスバーのタイムラインの最後のセクションが灰色で表示される場合があります。また、記録されたセッションの最後のセクションはアイドル状態です。記録されたセッションに常にアクティビティがある場合、これは明らかではありません。

7. 報告された問題がトリアージまたは解決されたら、Stop-BrokerSessionRecordingコマンドを使用して記録を停止します。

   次の表は、このコマンドの一般的な使用方法を示しています。

   コマンド	説明文
   Stop-BrokerSessionRecording -User DomainA \ ユーザーA	DomainAという名前のドメイン内のユーザーUserAのすべてのセッションの記録を停止します。
   Stop-BrokerSessionRecording -Sessions $SessionObject	$SessionObject内のすべてのセッションの記録を停止します。
   Stop-BrokerSessionRecording -Sessions uid1,uid2,…,uidn	UID1、UID2、…、およびUIDnのセッションの記録を停止します。

Citrix Studioのログ画面で、Start-BrokerSessionRecordingコマンドとStop-BrokerSessionRecordingコマンドの結果ログを表示できます。