動的セッションレコーディング
以前は、レコーディングポリシーに合致するセッションは、その開始時に厳密にセッションレコーディングが開始され、セッションが終了すると厳密に停止していました。
7.18リリース以降、Citrixは動的セッションレコーディング機能を導入します。この機能を使用すると、特定のセッション、または特定のユーザーが起動するセッションのレコーディングを、セッション中にいつでも開始または停止できます。
注：
この機能を期待どおりに動作させるには、Session Recording、VDA、およびDelivery Controllerをバージョン7.18以降にアップグレードしてください。
動的セッションレコーディングを有効または無効にする
Session Recordingエージェントでは、この機能を有効または無効にするためのレジストリ値が追加されます。このレジストリ値はデフォルトで1に設定されており、これはこの機能がデフォルトで有効になっていることを意味します。
この機能を有効または無効にするには、次の手順を実行します。
- Session Recordingのインストールが完了したら、Session Recordingエージェントをインストールしたマシンに管理者としてログオンします。
- レジストリエディターを開きます。
-
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditorに移動します。 - DynamicControlAllowedの値を0に設定するか、デフォルト値の1を使用します。 1: 動的レコーディングを有効にする 0: 動的レコーディングを無効にする
- 設定を有効にするには、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).
To determine which SDK to install and use, be aware of the Delivery Controller™ that you specified when creating your recording policy. If you select the Citrix Cloud Controller check box to record sessions in a Citrix Cloud environment, you must validate your Citrix Cloud credentials.
コントローラーへのクエリを作成する(/ja-jp/session-recording/2209/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 コマンドを示します。
| コマンド | 説明文 |
|---|---|
| Start-BrokerSessionRecording | 特定の有効なセッション、有効なセッションのリスト、または特定のユーザーによって起動されたセッションの録画を開始できます。詳細については、Get-Help Start-BrokerSessionRecording を実行してコマンドのオンラインヘルプを参照してください。 |
| Stop-BrokerSessionRecording | 特定の有効なセッション、有効なセッションのリスト、または特定のユーザーによって起動されたセッションの録画を停止できます。詳細については、Get-Help Stop-BrokerSessionRecording を実行してコマンドのオンラインヘルプを参照してください。 |
| Get-BrokerSessionRecordingStatus | 特定の有効なセッションの録画ステータスを取得できます。詳細については、Get-Help Get-BrokerSessionRecordingStatus を実行してコマンドのオンラインヘルプを参照してください。 |
例えば、ユーザーが問題を報告し、タイムリーなサポートが必要な場合、この機能を使用してユーザーのアクティブなセッションの記録を動的に開始できます。ライブ記録を再生して、その後のトラブルシューティングを進めることができます。次のことができます。
-
(For Citrix Virtual Apps™ and Desktops PowerShell SDK only) Launch PowerShell from the Citrix Studio console.
パワーシェルを起動する(/ja-jp/session-recording/2209/media/launch-powershell.jpg)
-
Get-BrokerSessionコマンドを使用して、ターゲットユーザーのすべてのアクティブなセッションを取得します。ブローカーセッション取得コマンドを実行する(/ja-jp/session-recording/2209/media/run-get-broker-session.png)
-
Get-BrokerSessionRecordingStatusコマンドを使用して、指定されたセッションの記録ステータスを取得します。セッションステータス取得の実行(/ja-jp/session-recording/2209/media/run-get-session-status.png)
注:
-Session パラメーターは、一度に1つのセッション UID のみを受け入れます。
-
Start-BrokerSessionRecordingコマンドを使用して記録を開始します。デフォルトでは、記録アクティビティをユーザーに通知するメッセージが表示されます。次の表は、
Start-BrokerSessionRecordingコマンドの一般的な使用方法を示しています。コマンド 説明文 Start-BrokerSessionRecording -User DomainA \ UserADomainA という名前のドメインでユーザー 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 である必要があります。 -
「ライブ」または「完了」の記録を再生し、その後のトラブルシューティングに進みます。
注：
Stop-BrokerSessionRecordingコマンドによって終了された Complete 記録を再生すると、プレーヤーのプログレスバーのタイムラインの最後のセクションが灰色で表示されることがあります。また、記録されたセッションの最後のセクションはアイドル状態です。記録されたセッションに常にアクティビティがある場合、これは明らかではありません。 -
報告された問題がトリアージまたは解決されたら、
Stop-BrokerSessionRecordingコマンドを使用して記録を停止します。次の表は、このコマンドの一般的な使用方法を示しています。
コマンド 説明文 Stop-BrokerSessionRecording -User DomainA\ ユーザーADomainA という名前のドメイン内のユーザー UserA のすべてのセッションの記録を停止します。 Stop-BrokerSessionRecording -Sessions $SessionObject$SessionObject 内のすべてのセッションの記録を停止します。 Stop-BrokerSessionRecording -Sessions uid1,uid2,…,uidnセッション UID1、UID2、…、およびUIDnの記録を停止します。
Citrix Studio の ログ 画面で、Start-BrokerSessionRecording および Stop-BrokerSessionRecording コマンドの結果ログを表示できます。
