動的セッション記録

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

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を決定するには、記録ポリシーの作成時に指定したデリバリーコントローラー™に注意してください。Citrix Cloud環境でセッションを記録するためにCitrix Cloud Controllerチェックボックスを選択した場合、Citrix Cloudの資格情報を検証する必要があります。

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

注:

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

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

コマンド 説明文
スタート-ブローカーセッションレコーディング 特定のアクティブなセッション、アクティブなセッションのリスト、または特定のユーザーによって起動されたセッションの記録を開始できます。ポリシー設定に従って特定のセッションが元々イベントのみの記録に設定されている場合、このコマンドを使用すると、ターゲットイベントに加えて画面のキャプチャを開始できます。詳細については、Get-Help Start-BrokerSessionRecordingを実行してコマンドのオンラインヘルプを参照してください。
ストップ-ブローカーセッションレコーディング 特定のアクティブなセッション、アクティブなセッションのリスト、または特定のユーザーによって起動されたセッションの記録を停止できます。詳細については、Get-Help Stop-BrokerSessionRecordingを実行してコマンドのオンラインヘルプを参照してください。
Get-BrokerSessionRecordingStatus 特定のアクティブなセッションの記録ステータスを取得できます。詳細については、Get-Help Get-BrokerSessionRecordingStatusを実行してコマンドのオンラインヘルプを参照してください。

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

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

    パワーシェルを起動

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

    ブローカーセッションの取得を実行

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

    セッションステータスの取得を実行

    注:

    -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. LiveまたはCompleteの記録を再生し、その後のトラブルシューティングに進みます。

    注:

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

スタジオログ記録画面

動的セッション記録