動的セッション記録

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

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/current-release/media/create-query-to-ddc.png)

注：

Citrix DaaS Remote PowerShell SDKをCitrix Cloud Connector™マシンにインストールしないでください。Remote PowerShell SDKは、同じリソースの場所にある任意のドメイン参加済みマシンにインストールできます。このSDKのコマンドレットをCloud Connectorで実行しないことをお勧めします。SDKの操作にはCloud Connectorは関与しません。

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

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

1. (For Citrix Virtual Apps™ and Desktops PowerShell SDK only) Launch PowerShell from the Citrix Studio console.

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

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

   ブローカーセッションの取得を実行(/ja-jp/session-recording/current-release/media/run-get-broker-session.png)

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

   セッションステータスの取得を実行(/ja-jp/session-recording/current-release/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コマンドによって終了されたComplete記録を再生すると、プレーヤーのプログレスバーのタイムラインの最後のセクションが灰色で表示されることがあります。また、記録されたセッションの最後のセクションはアイドル状態です。記録されたセッションに継続的なアクティビティがある場合、これは明らかではありません。

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コマンドの結果のログを表示できます。