動的セッションレコーディング
以前は、レコーディングポリシーに合致するセッションの開始時にセッションレコーディングが厳密に開始され、それらのセッションが終了すると厳密に停止していました。
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 コマンドを使用して、動的に録画を開始または停止する
動的セッション録画機能は、オンプレミス環境とCitrix Cloud環境の両方で使用できます。オンプレミス環境でこの機能を使用するには、Citrix Virtual Apps and Desktops™ PowerShell SDKを使用します。Citrix Cloud環境でこの機能を使用するには、Citrix DaaS リモート PowerShell SDK（旧称：Citrix Virtual Apps and Desktops リモート PowerShell SDK）を使用します。
インストールして使用するSDKを決定するには、録画ポリシーの作成時に指定したDelivery Controller™に注意してください。Citrix Cloud環境でセッションを録画するためにCitrix Cloud Controllerチェックボックスを選択した場合は、Citrix Cloudの資格情報を検証する必要があります。
コントローラーへのクエリを作成する(/ja-jp/session-recording/2411/media/create-query-to-ddc.png)
注：
Citrix DaaS Remote PowerShell SDK を Citrix Cloud Connector™ マシンにインストールしないでください。Remote PowerShell SDK は、同じリソースの場所にある任意のドメイン参加済みマシンにインストールできます。この SDK のコマンドレットを Cloud Connectors で実行することはお勧めしません。SDK の操作には Cloud Connectors は関与しません。
次の表に、両方の Citrix SDK が動的セッション録画用に提供する 3 つの PowerShell コマンドを示します。
| コマンド | 項目説明 |
|---|---|
| スタート-ブローカーセッションレコーディング | 特定の有効なセッション、有効なセッションのリスト、または特定のユーザーによって起動されたセッションの録画を開始できます。特定のセッションがポリシー設定に従ってイベントのみの録画用に元々設定されている場合、このコマンドを使用すると、ターゲットイベントに加えて画面のキャプチャを開始できます。詳細については、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/2411/media/launch-powershell.jpg)
-
Get-BrokerSessionコマンドを使用して、ターゲットユーザーのすべてのアクティブなセッションを取得します。ブローカーセッションの取得を実行する(/ja-jp/session-recording/2411/media/run-get-broker-session.png)
-
Get-BrokerSessionRecordingStatusコマンドを使用して、指定されたセッションの記録ステータスを取得します。セッションステータスの取得を実行する(/ja-jp/session-recording/2411/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 $falseDomainAという名前のドメインで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であるはずです。 -
LiveまたはCompleteの記録を再生し、その後のトラブルシューティングに進みます。
注：
Stop-BrokerSessionRecordingコマンドによって終了されたComplete記録を再生すると、プレーヤーのプログレスバーのタイムラインの最後のセクションが灰色で表示される場合があります。また、記録されたセッションの最後のセクションはアイドル状態です。記録されたセッションに継続的なアクティビティがある場合、これは明らかではありません。 -
報告された問題がトリアージまたは解決されたら、
Stop-BrokerSessionRecordingコマンドを使用して記録を停止します。次の表は、このコマンドの一般的な使用方法を示しています。
コマンド 説明文 Stop-BrokerSessionRecording -User DomainA\ ユーザーADomainAという名前のドメイン内のユーザーUserAのすべてのセッションの記録を停止します。 Stop-BrokerSessionRecording -Sessions $SessionObject$SessionObject内のすべてのセッションの記録を停止します。 Stop-BrokerSessionRecording -Sessions uid1,uid2,…,uidnUID1、UID2、…、およびUIDnのセッションの記録を停止します。
Citrix Studioのログ画面で、Start-BrokerSessionRecordingコマンドとStop-BrokerSessionRecordingコマンドの結果ログを表示できます。
