Session Recording 2503

インストール、アップグレード、アンインストール

August 1, 2026

寄稿者:

C C

注：

負荷分散によってサーバーの高可用性を構成するには、「既存の展開で負荷分散を構成する」および「Azure でのセッション録画の展開と負荷分散」を参照してください。

Citrix Session RecordingおよびCitrix Session Recordingサービスを迅速にセットアップおよび構成する方法について、さらに詳しく知るには、Citrix Tech Zoneの記事「概念実証ガイド：Citrix Session Recording」(/ja-jp/tech-zone/learn/poc-guides/session-recording.html)を参照してください。

Session RecordingサーバーとエージェントをAzure AD参加済みマシンにインストールし、それらに対してAzure ADサポートを有効にすることができます。後でクラウドからさまざまなポリシーと再生権限を構成する際に、Azure AD参加済みマシンからセッションを起動するAzure ADユーザーとグループを指定できます。Citrix Virtual Apps and Desktops™インストーラーを使用してSession Recordingサーバーをインストールする場合、GUIではAzure ADサポートを有効にするオプションは利用できません。

この記事には、次のセクションが含まれています。

インストールチェックリスト

Citrix®スクリプトを使用してWindowsの役割と機能の前提条件をインストールする

Citrix仮想アプリおよびデスクトップのインストールプログラムを使用してSession Recordingをインストールする

インストールの自動化

クラウドSQLデータベースサービスにSession Recordingデータベースをインストールする

セッションレコーディングのアップグレード

セッションレコーディングのアンインストール

シトリックスアナリティクスフォーセキュリティとの統合

インストールチェックリスト

インストールを開始する前に、このリストを完了してください:

✔	手順
	各Session Recordingコンポーネントをインストールするマシンを選択します。各コンピューターが、インストールされるコンポーネントのハードウェアおよびソフトウェア要件を満たしていることを確認してください。
	Citrixアカウントの資格情報を使用して、Citrix Virtual Apps™ and Desktopsのダウンロードページにアクセスし、製品のISOファイルをダウンロードします。ISOファイルを解凍するか、DVDに書き込みます。
	Session Recordingコンポーネント間の通信にTLSプロトコルを使用するには、環境に適切な証明書をインストールします。
	Session Recordingコンポーネントに必要なすべてのホットフィックスをインストールします。ホットフィックスはCitrix Supportから入手できます。
	Citrix Director を構成して、Session Recording ポリシーを作成およびアクティブ化します。詳しくは、「Director を構成して Session Recording Server を使用する」(/ja-jp/session-recording/current-release/configure/policies/session-recording-policies#configure-the-director-to-use-the-session-recording-server) を参照してください。

注：

公開アプリケーションは、記録ポリシーに基づいて個別のデリバリーグループに分割することをお勧めします。公開アプリケーションが同じデリバリーグループにある場合、公開アプリケーションのセッション共有はアクティブなポリシーと競合する可能性があります。Session Recordingは、ユーザーが最初に開いた公開アプリケーションとアクティブなポリシーを照合します。7.18リリース以降、動的セッション記録機能を使用して、セッション中にいつでも記録セッションを開始または停止できます。この機能は、アクティブなポリシーとの競合の問題を軽減するのに役立ちます。詳しくは、「Dynamic session recording」を参照してください。

Machine Creation Services™ (MCS) または Provisioning Services を使用する予定がある場合は、一意の QMId を準備してください。これに従わない場合、記録データが失われる可能性があります。

SQLサーバーには、TCP/IP、実行中のSQLサーバーブラウザーサービス、および有効なウィンドウズ認証が必要です。

HTTPSを使用するには、TLS/HTTPS用のサーバー証明書を構成します。

ローカルユーザーとグループ > グループ > ユーザーのユーザーが、C:\windows\Tempフォルダーへの書き込み権限を持っていることを確認してください。

（msiインストールの場合のみ必須）Citrixスクリプトを使用してWindowsの役割と機能の前提条件をインストールする

セッション録画が正常に機能するためには、以下のCitrixスクリプトを使用して、必要なWindowsの役割と機能の前提条件をインストールする前にセッション録画をインストールしてください。

InstallPrereqsforSessionRecordingAdministration.ps1

 <#
 .Synopsis
     Installs Prereqs for Session Recording Administration
 .Description
     Supports Windows Server 2025, Windows Server 2022, Windows Server 2019.
     Install below windows feature on this machine:
     -Application Development
     -Security - Windows Authentication
     -Management Tools - IIS 6 Management Compatibility
         IIS 6 Metabase Compatibility
         IIS 6 WMI Compatibility
         IIS 6 Scripting Tools
         IIS 6 Management Console
     -Microsoft Message Queuing (MSMQ), with Active Directory integration disabled, and MSMQ HTTP support enabled.
 #>
 function AddFeatures($featurename)
 {
     try
     {
         $feature=Get-WindowsFeature | ? {$_.DisplayName -eq $featurename -or $_.Name -eq $featurename}
         Add-WindowsFeature $feature
     }
     catch
     {
         Write-Host "Addition of Windows feature $featurename failed"
         Exit 1
     }
     Write-Host "Addition of Windows feature $featurename succeeded"
 }

 $system= gwmi win32_operatingSystem | select name

 if (-not (($system -Like '*Microsoft Windows Server 2025*') -or ($system -Like '*Microsoft Windows Server 2022*') -or ($system -Like '*Microsoft Windows Server 2019*')))
 {
     Write-Host("This is not a supported server platform. Installation aborted.")
     Exit
 }

 # Start to install Windows feature
 Import-Module ServerManager

 AddFeatures('Web-Asp-Net45') #ASP.NET 4.5
 AddFeatures('Web-Mgmt-Console') #IIS Management Console
 AddFeatures('Web-Windows-Auth') # Windows Authentication
 AddFeatures('Web-Metabase') #IIS 6 Metabase Compatibility
 AddFeatures('Web-WMI') #IIS 6 WMI Compatibility
 AddFeatures('Web-Lgcy-Scripting')#IIS 6 Scripting Tools
 if (($system -Like '*Microsoft Windows Server 2022*') -or ($system -Like '*Microsoft Windows Server 2019*'))
 {
     AddFeatures('Web-Lgcy-Mgmt-Console') #IIS 6 Management Console
 }

 AddFeatures('MSMQ-HTTP-Support') #MSMQ HTTP Support
 AddFeatures('web-websockets') #IIS Web Sockets
 AddFeatures('NET-WCF-HTTP-Activation45') #http activate
 AddFeatures('Web-IP-Security')#IIS-IPSecurity
 <!--NeedCopy-->

InstallPrereqsforSessionRecordingAgent.ps1

 <#
 .Synopsis
     Installs Prereqs for Session Recording Agent
 .Description
     Supports  Windows Server 2025, Windows Server 2022, Windows Server 2019, Windows Server 2016, windows 11, and Windows 10.
     Install below windows feature on this machine:
     -Microsoft Message Queuing (MSMQ), with Active Directory integration disabled, and MSMQ HTTP support enabled.
 #>
 function AddFeatures($featurename)
 {
     try
     {
         $feature=Get-WindowsFeature | ? {$_.DisplayName -eq $featurename -or $_.Name -eq $featurename}
         Add-WindowsFeature $feature
     }
     catch
     {
         Write-Host "Addition of Windows feature $featurename failed"
         Exit 1
     }
     Write-Host "Addition of Windows feature $featurename succeeded"
 }

 # Start to install Windows feature

 $system= gwmi win32_operatingSystem | select name

 if (-not (($system -Like '*Microsoft Windows Server 2025*') -or ($system -Like '*Microsoft Windows Server 2022*') -or ($system -Like '*Microsoft Windows Server 2019*') -or ($system -Like '*Microsoft Windows Server 2016*') -or ($system -Like '*Microsoft Windows 11*') -or ($system -Like '*Microsoft Windows 10*')))
 {
     Write-Host("This is not a supported platform. Installation aborted.")
     Exit
 }

 if ($system -Like '*Microsoft Windows Server*')
 {
     Import-Module ServerManager
     AddFeatures('MSMQ-Server') #Message Queuing
 }
 else
 {
     try
     {
         dism /online /enable-feature /featurename:MSMQ-Server /all
     }
     catch
     {
         Write-Host "Addition of Windows feature MSMQ failed"
         Exit 1
     }
     write-Host "Addition of Windows feature MSMQ succeeded"
 }
 <!--NeedCopy-->

Windowsの役割と機能の前提条件をインストールするには、次の手順を実行します。

セッション録画管理コンポーネントをインストールする予定のマシンで、
1. PowerShellで実行ポリシーがRemoteSignedまたはUnrestrictedに設定されていることを確認します。
```
Set-ExecutionPolicy RemoteSigned

```
2. 管理者としてコマンドプロンプトを起動し、powershell.exe -file InstallPrereqsforSessionRecordingAdministration.ps1コマンドを実行します。
  
  スクリプトは、正常に追加された機能を表示し、その後停止します。
3. スクリプトの実行後、実行ポリシーが会社のポリシーに基づいて適切な値に設定されていることを確認します。
セッション録画エージェントコンポーネントをインストールする予定のマシンで、
1. PowerShellで実行ポリシーがRemoteSignedまたはUnrestrictedに設定されていることを確認します。
```
Set-ExecutionPolicy RemoteSigned

```
2. 管理者としてコマンドプロンプトを起動し、powershell.exe -file InstallPrereqsforSessionRecordingAgent.ps1コマンドを実行します。
  
  スクリプトは、正常に追加された機能を表示し、その後停止します。
3. スクリプトの実行後、実行ポリシーが会社のポリシーに基づいて適切な値に設定されていることを確認します。

Citrix Virtual Apps and Desktopsインストーラーを使用したセッション録画のインストール

Citrix Session Recording は以下のコンポーネントで構成されています。

セッションレコーディング管理（セッションレコーディングデータベース、セッションレコーディングサーバー、およびセッションレコーディングポリシーコンソールを含む）
セッションレコーディングエージェント
セッションレコーディングプレーヤー
セッションレコーディングWebプレーヤー

すべてのコンポーネントを単一のサーバーにインストールすることは概念実証としては許容されますが、以下のように別々のサーバーにインストールすることをお勧めします。

マシンAにMicrosoft SQL Serverをインストールします。
マシンBにセッションレコーディングサーバー、セッションレコーディング管理者ログ、およびセッションレコーディングデータベースをインストールします。

注：

Session Recordingデータベースは実際のデータベースではありません。これは、インストール中にMicrosoft SQL Serverインスタンスに必要なデータベースを作成および構成するコンポーネントです。

Session Recordingサーバーをインストールすると、Session Recording Webプレイヤーを自動的にインストールできます。
マシンCにSession Recordingポリシーコンソールをインストールします。
マシンCまたはマシンDのいずれかにSession Recordingプレイヤーをインストールします。
VDAにSession Recordingエージェントをインストールします。

セッションレコーディング管理コンポーネントをインストールする

Session Recordingエージェントをインストールする

Session Recordingプレイヤーをインストールする

Session Recording管理コンポーネントをインストールする

注：

デフォルトでは、セキュリティ保護のため、Session RecordingはTLSが有効なシナリオでのみ機能します。つまり、Session Recording IIS -> デフォルトWebサイトに有効な証明書をバインドする必要があります。バインド時にホスト名を指定しないでください。

セッションレコーディングにHTTPのみを使用する場合は、通信プロトコルとしてHTTPを使用するを参照してください。

Session Recording管理コンポーネントには、Session Recordingデータベース、Session Recordingサーバー、およびSession Recordingポリシーコンソールが含まれます。サーバーにインストールするコンポーネントを選択できます。

ステップ1：製品ソフトウェアをダウンロードしてウィザードを起動する

Citrixアカウントの資格情報を使用してCitrix Virtual Apps and Desktopsダウンロードページにアクセスし、製品のISOファイルをダウンロードします。ISOファイルを解凍するか、DVDに書き込みます。
Session Recording管理コンポーネントをインストールするマシンに、ローカル管理者アカウントを使用してログオンします。DVDをドライブに挿入するか、ISOファイルをマウントします。インストーラーが自動的に起動しない場合は、AutoSelectアプリケーションまたはマウントされたドライブをダブルクリックします。インストールウィザードが起動します。

ステップ2：インストールする製品を選択する

インストールする製品を選択する

Citrix Virtual AppsまたはCitrix Virtual Desktops™をインストールする製品の横にある開始をクリックします。

ステップ3：セッションレコーディングを選択する

セッションレコーディングを選択する

「Session Recording」の項目を選択してください。

ステップ4：ライセンス契約を読んで同意する

インストール契約(/ja-jp/session-recording/current-release/media/read-and-accept-the-license-agreement.png)

ソフトウェアライセンス契約ページで、ライセンス契約を読み、同意して、次へをクリックします。

ステップ5：インストールするコンポーネントとインストール場所を選択する

コンポーネントとインストールパスを選択(/ja-jp/session-recording/current-release/media/4-select-the-components-to-install-and-the-installation-location.png)

コアコンポーネントページで：

場所：デフォルトでは、コンポーネントはC:\Program Files\Citrixにインストールされます。デフォルトの場所はほとんどの展開で機能します。カスタムのインストール場所を指定できます。
コンポーネント：デフォルトでは、インストール可能なコンポーネントの横にあるすべてのチェックボックスが選択されています。インストーラーは、シングルセッションOSまたはマルチセッションOSのどちらで実行されているかを認識します。Session Recording管理コンポーネントはマルチセッションOSにのみインストールできます。Session Recordingエージェントは、VDAがインストールされているマシンにのみインストールできます。VDAが事前にインストールされていないマシンにSession Recordingエージェントをインストールすると、Session Recording Agentオプションは利用できません。

「セッションレコーディング管理」を選択し、「次へ」をクリックします。

セッションレコーディング管理が選択されている様子(/ja-jp/session-recording/current-release/media/select-the-components-to-install-and-the-installation-location.png)

ステップ6：インストールする機能を選択する

インストールする機能を選択(/ja-jp/session-recording/current-release/media/select-the-features-to-install.png)

機能ページで：

デフォルトでは、インストール可能な機能の横にあるすべてのチェックボックスが選択されています。概念実証の場合、これらすべての機能を単一のサーバーにインストールしても問題ありません。大規模な本番環境では、Session Recordingポリシーコンソールを別のサーバーにインストールします。Session Recordingサーバー、管理者ログ、およびデータベースは別のサーバーにインストールします。
セッションレコーディング管理者ログは、セッションレコーディングサーバーのオプションのサブ機能です。セッションレコーディング管理者ログを選択する前に、セッションレコーディングサーバーを選択してください。セッションレコーディングデータベースは、セッションレコーディングサーバーの必須サブ機能です。セッションレコーディングサーバーがインストール用に選択されると、セッションレコーディングデータベースも自動的に選択され、選択を解除することはできません。
セッションレコーディングサーバーを選択すると、セッションレコーディングWebプレーヤーもインストールされます。
機能を選択してインストールした後、同じサーバーに機能を追加するには、msiパッケージのみを使用できます。インストーラーを再度実行することはできません。
セッションレコーディングサーバー

セッションレコーディングサーバーは、以下をホストするサーバーです。
- ブローカー。以下の目的を果たすIIS 6.0以降でホストされるWebアプリケーションです。
  - セッションレコーディングプレーヤーおよびWebプレーヤーからの検索クエリとファイルダウンロード要求の処理。
  - セッションレコーディングポリシーコンソールからのポリシー管理要求の処理。
  - 各シトリックスバーチャルアップスアンドデスクトップスまたはシトリックス DaaS™（旧シトリックスバーチャルアップスアンドデスクトップスサービス）セッションにおけるレコーディングポリシーの評価。
- ストレージマネージャー。各セッションレコーディング対応VDAから受信した記録済みセッションファイルを管理するWindowsサービスです。
- 管理者ログ。管理アクティビティをログに記録するために、セッションレコーディングサーバーとともにインストールされるオプションのサブコンポーネントです。すべてのログデータは、デフォルトでCitrixSessionRecordingLoggingという名前の別のSQL Serverデータベースに保存されます。データベース名はカスタマイズできます。
セッションレコーディングデータベース
- セッションレコーディングデータベースは、実際のデータベースではありません。これは、インストール中にMicrosoft SQL Serverインスタンスに必要なデータベースを作成および構成するコンポーネントです。セッションレコーディングは、Microsoft SQL Serverに基づいたデータベース高可用性の3つのソリューションをサポートしています。詳しくは、「データベースの高可用性」を参照してください。
- Session Recordingデータベースは、以下のクラウドSQLデータベースサービスにインストールできます。
  - アジュール SQLデータベース
  - アジュール SQLマネージドインスタンス
  - Azure 仮想マシン (VM) 上の SQL サーバー
  - AWS アールディーエス
  - グーグルクラウドエスキューエルサーバー
セッションレコーディング管理ログ

Session Recording管理者ログは、Session Recordingサーバーと同時にインストールすることをお勧めします。管理者ログ機能を有効にしたくない場合は、後のページで無効にできます。ただし、この機能を最初にインストールしないことを選択し、後で追加したい場合は、SessionRecordingAdministrationx64.msiを使用して手動で追加することしかできません。
セッションレコーディングポリシーコンソール

Session Recordingポリシーコンソールを使用して、ポリシーを構成できます。

手順6.1：Session Recordingサーバー、データベース、および管理者ログのインストール

前述のとおり、Session RecordingデータベースはSession Recordingサーバーの必須サブ機能であり、Session Recording管理者ログはSession Recordingサーバーと同時にインストールすることをお勧めします。したがって、このセクションでは、3つのコンポーネントを同じマシンにインストールする手順を説明します。

[機能] ページで、[Session Recordingサーバー] と [Session Recording管理者ログ] を選択します。[Session Recordingサーバー] を選択すると、[Session Recordingデータベース] も自動的に選択されます。[次へ] をクリックします。
[データベースとサーバーの構成] ページで、Session Recordingデータベースのインスタンス名とデータベース名を指定し、必要に応じて [SQL Server認証] を有効にして、[次へ] をクリックします。

注：

2507以降、Session RecordingはSQL Server認証に加えて、Cloud Managed Entra IDアカウントを使用したEntra ID（旧Azure Active Directory）パスワードおよびサービスプリンシパル認証をサポートします。詳細については、「単一コマンドを使用してSession Recording管理コンポーネントの完全なセットをインストールする」を参照してください。

「データベースとサーバーの構成」ページで：
- SQL Server認証を有効にする：このオプションを使用すると、SQL Server認証を使用してSession Recordingデータベースに接続できます。
- インスタンス名：データベースインスタンスが名前付きインスタンスでない場合は、SQL Serverのコンピューター名のみを使用できます。インスタンス設定中にインスタンスに名前を付けた場合は、データベースインスタンス名としてコンピューター名\インスタンス名を使用します。使用しているサーバーインスタンス名を特定するには、SQL Serverで「select @@servername」を実行します。戻り値は正確なデータベースインスタンス名です。SQL Serverがデフォルトの1433ではなくカスタムポートを使用している場合は、インスタンス名にコンマとカスタムポートを追加します。たとえば、「インスタンス名」テキストボックスに「DXSBC-SRD-1,2433」と入力します。ここで「2433」はカスタムポートを示します。
- データベース名：「データベース名」テキストボックスにカスタムデータベース名を入力するか、テキストボックスにプリセットされているデフォルトのデータベース名を使用します。「接続のテスト」をクリックして、SQL Serverインスタンスへの接続とデータベース名の有効性をテストします。
  
  注：
  
  Session Recordingサーバーのデフォルトインストールでは、通信を保護するためにHTTPS/TLSを使用します。Session Recordingサーバーのデフォルトのインターネットインフォメーションサービス（IIS）サイトでTLSが構成されていない場合は、HTTPを使用します。そのためには、IISマネージャーコンソールでSession Recording Brokerサイトに移動し、SSL設定を開き、「Require SSL」チェックボックスをオフにして、SSLの選択を解除します。
  
  重要：
  
  カスタムデータベース名には、A～Z、a～z、0～9、およびアンダースコアのみを含める必要があり、123文字を超えることはできません。
  
  SQL Serverインスタンスのsecurityadminおよびdbcreatorサーバーロール権限が必要です。権限がない場合は、次のことができます。
  - データベース管理者に、インストールに必要な権限を割り当てるよう依頼します。インストールが完了すると、securityadminおよびdbcreatorサーバーロール権限は不要になり、安全に削除できます。
  - または、Citrix Virtual Apps and Desktops ISOの\x64\Session RecordingにあるSessionRecordingAdministrationx64.msiパッケージを使用します。msiインストール中に、securityadminおよびdbcreatorサーバーロール権限を持つデータベース管理者の資格情報を求めるダイアログボックスが表示されます。正しい資格情報を入力し、「OK」をクリックしてインストールを続行します。
    
    インストールによりSession Recordingデータベースが作成され、Session Recordingサーバーのコンピューターアカウントがdb_ownerとして追加されます。
管理ログ構成ページで、管理ログ機能の構成を指定します。

管理ログ構成ページ(/ja-jp/session-recording/current-release/media/administration-logging-configuration-page.png)

管理ログ構成ページで
- 管理ログデータベースはSQL Serverインスタンスにインストールされます: このテキストボックスは編集できません。管理ログデータベースのSQL Serverインスタンス名は、データベースとサーバーの構成ページで入力したインスタンス名から自動的に取得されます。2411リリース以降、Session Recording管理ログデータベースをSession Recordingデータベースとは別のインスタンスにインストールできます。これを行うには、インストールする前に次の手順を完了してください。
  1. Session Recordingサーバーをインストールするマシンに移動します。
  2. レジストリエディターを開きます。
  3. レジストリを変更します。
    - HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Serverに移動します。
    - SmAudDatabaseLoggingState DWORD (32ビット) 値を追加し、値のデータを1に設定します。
    - SmAudDatabaseLoggingInstance値を追加し、値のデータをSession Recording管理ログデータベースをインストールするインスタンス名に設定します。
  後でデータベースをインストールするときに、Session Recording管理ログデータベースは、SmAudDatabaseLoggingInstanceレジストリ値で指定された別のインスタンスにインストールされます。両方のデータベースに同じ認証モード（SQL Server認証、Windows認証、またはMicrosoft Entra ID認証）を構成し、同じユーザー権限を付与する必要があります。
- 管理者ログデータベース名: Session Recording管理者ログ機能をインストールするには、このテキストボックスに管理者ログデータベースのカスタムデータベース名を入力するか、テキストボックスに事前設定されているデフォルトのデータベース名CitrixSessionRecordingLoggingを使用します。
  
  注：
  
  管理者ログデータベース名は、前のデータベースとサーバーの構成ページのデータベース名テキストボックスで設定されているSession Recordingデータベース名とは異なる必要があります。
- 管理者ログデータベース名を入力した後、接続テストをクリックして、管理者ログデータベースへの接続をテストします。
- 管理ログを有効にする：デフォルトでは、管理ログ機能は有効になっています。チェックボックスをオフにすると無効にできます。
- 強制ブロックを有効にする：デフォルトでは、強制ブロックは有効になっています。ログ記録に失敗した場合、通常の機能がブロックされる可能性があります。チェックボックスをオフにすると、強制ブロックを無効にできます。
次へをクリックしてインストールを続行します。
前提条件を確認し、インストールを確定します。

概要ページには、選択したインストールオプションが表示されます。戻るをクリックして前のウィザードページに戻り変更を加えるか、インストールをクリックしてインストールを開始できます。
インストールを完了します。

インストールの完了ページには、正常にインストールおよび初期化されたすべての前提条件とコンポーネントに緑色のチェックマークが表示されます。

完了をクリックして、Session Recordingサーバー、データベース、および管理者ログのインストールを完了します。

手順6.2：Session Recordingポリシーコンソールをインストールする

Session Recordingポリシーコンソールをインストールするには、次の手順を実行します。

機能ページで、Session Recordingポリシーコンソールを選択し、次へをクリックします。
前提条件を確認し、インストールを確定します。

ポリシーコンソールのインストール概要(/ja-jp/session-recording/current-release/media/install-policy-console-2.png)

[概要] ページには、インストール選択が表示されます。[戻る] をクリックして以前のウィザードページに戻り変更を加えるか、[インストール] をクリックしてインストールを開始できます。
インストールを完了します。

ポリシーコンソールのインストールを完了する(/ja-jp/session-recording/current-release/media/install-policy-console-3.png)

[インストール完了] ページには、正常にインストールおよび初期化されたすべての前提条件とコンポーネントに緑色のチェックマークが表示されます。

[完了] をクリックして、Session Recordingポリシーコンソールのインストールを完了します。

Step 7: Install Broker_PowerShellSnapIn_x64.msi

重要：

Session Recordingポリシーコンソールを使用するには、Broker PowerShell Snap-in (Broker_PowerShellSnapIn_x64.msi) を手動でインストールします。Citrix Virtual Apps and Desktops ISO (\x64\Citrix Desktop Delivery Controller) でスナップインを見つけ、インストール手順に従ってください。これに従わないと、エラーが発生する可能性があります。

Session Recordingエージェントをインストールする

Session Recordingエージェントは、記録を有効にするためにマルチセッションOSまたはシングルセッションOSの各VDAにインストールされるコンポーネントです。セッションデータの記録を担当します。

手順1：製品ソフトウェアをダウンロードしてウィザードを起動する

Session Recordingエージェントをインストールするマシンに、ローカル管理者アカウントを使用してログオンします。DVDをドライブに挿入するか、ISOファイルをマウントします。インストーラーが自動的に起動しない場合は、AutoSelectアプリケーションまたはマウントされたドライブをダブルクリックします。

インストールウィザードが起動します。

ステップ2：インストールする製品を選択する

インストールする製品を選択する(/ja-jp/session-recording/current-release/media/install-agent-1-choose.png)

「Citrix Virtual Apps」または「Citrix Virtual Desktops」をインストールするための製品の横にある「Start」をクリックしてください。

ステップ3：セッションレコーディングを選択します

インストールするSession Recordingエージェントを選択する(/ja-jp/session-recording/current-release/media/install-agent-2-select.png)

「セッションレコーディング」エントリを選択します。

ステップ4：ライセンス契約を読んで同意する

インストール契約(/ja-jp/session-recording/current-release/media/install-agent-3-license-agreement.png)

ソフトウェアライセンス契約ページで、ライセンス契約を読み、同意してから次へをクリックします。

ステップ5：インストールするコンポーネントとインストール場所を選択する

インストールするエージェントを選択する(/ja-jp/session-recording/current-release/media/install-agent-4-location.png)

Session Recording Agentを選択し、次へをクリックします。

ステップ6：エージェント構成を指定する

エージェント構成(/ja-jp/session-recording/current-release/media/agent-configuration.png)

エージェント構成ページで、次の設定を完了します。

Session Recordingサーバーをインストールしたマシンのコンピューター名、およびSession Recordingサーバーへの接続に使用するプロトコルとポート情報を入力します。Session Recordingをまだインストールしていない場合は、後でSession Recording Agent Propertiesでこの情報を変更できます。
後でSession RecordingメッセージキューまたはMSMQを手動でインストールする場合は、「MSMQインストールをスキップ」をオンにできます。このオプションを使用すると、Microsoft Message Queuing（MSMQ）をインストールせずに続行できます。
Azure AD参加済みマシンにSession Recordingエージェントをインストールする場合は、Azure ADサポートを有効にするを選択します。クラウドから再生権限とさまざまなSession Recordingポリシーを構成するためのAzure AD IDサポートを完全に有効にするには、次の手順を完了してからVDAを再起動します。

注：

Azure ADサポートはプレビュー機能です。Session Recordingバージョン2402以降で利用できます。

プレビュー機能は完全にローカライズされていない場合があり、非実稼働環境での使用が推奨されます。Citrixテクニカルサポートは、プレビュー機能で発見された問題についてはサポートしません。
- Azure AD参加済みマシンにSession Recordingサーバーをインストールする場合も、MSIパッケージを使用します。MSIインストール中にAzure ADサポートを有効にするを選択します。
- シトリックスクラウドをAzure ADに接続する。
- Full Configurationインターフェイスのホームぺージに移動し、プレビュー機能セクションでSessionRecordingSupportAADとSend User Identity Info In Prepare Sessionのトグルを有効にします。Full Configurationインターフェイスのホームぺージにアクセスするには、次の手順を完了します。
  1. Citrix Cloudにサインインします。
  2. 左上のメニューで、マイサービス > DaaSを選択します。デフォルトでは、Full Configurationインターフェイスのホームぺージが表示されます。

注：

インストーラーの接続テスト機能には制限があります。「HTTPS requires TLS 1.2」のシナリオはサポートしていません。このシナリオでインストーラーを使用すると、接続テストは失敗しますが、その失敗を無視して次へをクリックしてインストールを続行できます。これは通常の機能には影響しません。

手順7：前提条件を確認し、インストールを確定する

「エージェントのインストール概要」(/ja-jp/session-recording/current-release/media/install-agent-5.png)

「概要」ページには、インストール選択が表示されます。「戻る」をクリックして前のウィザードページに戻り変更を行うか、「インストール」をクリックしてインストールを開始できます。

ステップ8：インストールの完了

「エージェントのインストール完了」(/ja-jp/session-recording/current-release/media/install-agent-6.png)

「インストールの完了」ページには、正常にインストールおよび初期化されたすべての前提条件とコンポーネントの緑色のチェックマークが表示されます。

「完了」をクリックして、Session Recording Agent のインストールを完了します。

注：

Machine Creation Services (MCS) または Citrix Provisioning™ がマスターイメージと Microsoft Message Queuing (MSMQ) がインストールされた複数の VDA を作成すると、VDA が同じ QMId を持つ場合があります。同じ QMId は、たとえば次のようなさまざまな問題を引き起こす可能性があります。

録画契約が承認されていても、セッションが録画されない場合があります。

Session Recording Server がセッションログオフ信号を受信できないため、セッションが常にライブ状態になる可能性があります。

回避策として、各 VDA に一意の QMId を作成します。これは展開方法によって異なります。

Session Recording Agent がインストールされたシングルセッションOS VDA が、PVS 7.7以降およびMCS 7.9以降で静的デスクトップモード（たとえば、個別のPersonal vDiskまたはVDAのローカルディスクですべての変更を永続化するように構成されている）で作成されている場合、追加のアクションは必要ありません。

MCSまたはPVSで作成されたマルチセッションOS VDA、およびユーザーがログオフしたときにすべての変更を破棄するように構成されたシングルセッションOS VDAの場合、システム起動時に GenRandomQMID.ps1 スクリプトを使用して QMId を変更します。ユーザーのログオン試行前に十分なVDAが実行されていることを確認するために、電源管理戦略を変更してください。

GenRandomQMID.ps1 スクリプトを使用するには、次の手順を実行します。

PowerShell で実行ポリシーが RemoteSigned または Unrestricted に設定されていることを確認します。

Set-ExecutionPolicy RemoteSigned

スケジュールされたタスクを作成し、トリガーをシステム起動時に設定し、PVSまたはMCSマスターイメージマシンでSYSTEMアカウントで実行します。

コマンドをスタートアップタスクとして追加します。

powershell .exe -file C:\\GenRandomQMID.ps1

Summary of the GenRandomQMID.ps1 script:

レジストリから現在のQMIdを削除します。

SysPrep = 1をHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSMQ\Parametersに追加します。

CitrixSmAudAgentおよびMSMQを含む関連サービスを停止します。

ランダムなQMIdを生成するには、以前に停止したサービスを開始します。

Example GENRANDOMQMID.PS1:
# Remove old QMId from registry and set SysPrep flag for MSMQ

Remove-Itemproperty -Path HKLM:Software\Microsoft\MSMQ\Parameters\MachineCache -Name QMId -Force

Set-ItemProperty -Path HKLM:Software\Microsoft\MSMQ\Parameters -Name "SysPrep" -Type DWord -Value 1

# Get dependent services

$depServices = Get-Service -name MSMQ -dependentservices | Select -Property Name

# Restart MSMQ to get a new QMId

Restart-Service -force MSMQ

# Start dependent services

if ($depServices -ne $null) {

    foreach ($depService in $depServices) {

        $startMode = Get-WmiObject win32_service -filter "NAME = '$($depService.Name)'" | Select -Property StartMode

         if ($startMode.StartMode -eq "Auto") {

             Start-Service $depService.Name
         }
}

}

Session Recording プレイヤーをインストールする

Session Recording Playerは、ワークステーションからアクセスして記録されたセッションファイルを再生するユーザーインターフェイスです。Session Recording Playerは、Session Recordingサーバーまたはドメイン内のワークステーションにインストールします。

ヒント：

Session Recording サーバーをインストールすると、Session Recording Web プレイヤーが自動的にインストールされます。

セッションレコーディングプレーヤーをインストールする前または後に、VC_redist.x86.exeという名前のMicrosoft Visual C++ 再頒布可能パッケージをインストールします。このパッケージは、Citrix Virtual Apps and Desktops ISOの\Support\VcRedistにあります。

ステップ 1: 製品ソフトウェアをダウンロードしてウィザードを起動する

Session Recording Playerコンポーネントをインストールするマシンに、ローカル管理者アカウントを使用してログオンします。DVDをドライブに挿入するか、ISOファイルをマウントします。インストーラーが自動的に起動しない場合は、AutoSelectアプリケーションまたはマウントされたドライブをダブルクリックします。

インストールウィザードが起動します。

ステップ 2: インストールする製品を選択する

インストールする製品を選択してください

Citrix Virtual AppsまたはCitrix Virtual Desktopsをインストールするには、製品の横にある開始をクリックします。

ステップ 3: セッションレコーディングを選択します

セッションレコーディングを選択

セッションレコーディング エントリを選択します。

ステップ 4: ライセンス契約を読んで同意する

インストール契約

ソフトウェアライセンス契約ページで、ライセンス契約を読み、同意して、次へをクリックします。

ステップ 5: インストールするコンポーネントとインストール場所を選択する

インストールするプレーヤーを選択

「セッションレコーディングプレーヤー」を選択し、「次へ」をクリックします。

ステップ6：前提条件を確認し、インストールを確定する

プレイヤーのインストール概要(/ja-jp/session-recording/current-release/media/install-player-4-confirm-installation.png)

概要ページには、インストール選択が表示されます。戻るをクリックして以前のウィザードページに戻り変更を加えるか、インストールをクリックしてインストールを開始できます。

ステップ7：インストールを完了する

プレイヤーのインストール完了(/ja-jp/session-recording/current-release/media/install-player-7-install-complete.png)

インストール完了ページには、正常にインストールおよび初期化されたすべての前提条件とコンポーネントに緑色のチェックマークが表示されます。

完了をクリックして、Session Recordingプレイヤーのインストールを完了します。

メッセージキューイングソリューションを選択する

Session Recordingのデフォルトのメッセージキューは、Microsoft Message Queue (MSMQ) です。Session Recordingは、MSMQの代替としてSession Recordingメッセージキューを提供します。そのインストールと構成については、このセクションで詳しく説明します。アクティブなメッセージキューは、レジストリ設定を使用して変更できます。

エムエスエムキュー

MSMQのユーザーは、Session Recordingのインストール後にアクセス制御リスト (ACL) を構成することをお勧めします。詳細については、「セキュリティに関する推奨事項」を参照してください。

セッションレコーディングメッセージキュー

Session Recordingメッセージキューソリューションは、Session Recordingの機能を次の方法で強化するように設計されています。

最新の.NET環境をサポート: WebSocketとnats.io上に構築されており、MSMQで必要とされる.NET Frameworkへの依存関係を排除します。
強化された機能を提供: 永続ストレージ、複数の認証方法、SSL暗号化、およびさまざまな構成オプションを提供します。
認証の柔軟性の向上: Azure ADまたはその他の非ADシナリオに対して、より優れた認証オプションをサポートします。

セッション記録メッセージキューのインストールと構成

セッション記録メッセージキューのインストールと構成を進めるには、以下の前提条件が満たされていることを確認してください。
- 管理者権限が必要です。
- セッション記録メッセージキューをインストールする前に、https://dotnet.microsoft.com/ja-jp/download/dotnet/8.0から.NET 8 Runtimeをインストールする必要があります。
VDAで、ISOファイルからメタインストーラーを使用するか、SessionRecordingAgentx64.msiを直接実行して、セッション記録エージェントをインストールします。

環境がセッション記録メッセージキューのみを使用し、MSMQに切り替えない場合は、セッション記録エージェントのインストール中に「MSMQのインストールをスキップ」オプションを選択できます。これにより、以下が保証されます。
- メタインストーラーによってMSMQがVDAにインストールされません。
- セッション記録エージェントサービスは、MSMQの依存関係で構成されません。
エージェントのインストールが完了したら、ISOファイルからSessionRecordingMsgQueue.msiを実行して、セッション記録メッセージキューを展開します。
VDAを再起動します。
セッション記録の権限、ポリシー、およびその他の設定を構成します。記録されたセッションは、セッション記録メッセージキューを介して送信できるようになります。

オプションの構成

SSL暗号化の使用

エージェントを構成します:
1. スタートメニューから「セッションレコーディングエージェントプロパティ」を開きます。
2. 接続タブに移動します。
3. セッションレコーディングブローカーで、プロトコルをHTTPSに変更します。
4. [OK] をクリックして変更を保存します。
5. シトリックスセッションレコーディングエージェントおよびシトリックスセッションレコーディングメッセージキューサービスを再起動します。
サーバーを構成します:
1. Session Recordingサーバーで、有効なSSL証明書がIISのDefault Web Siteにバインドされていることを確認します。

トラブルシューティング

通信の不具合

セッションレコーディングサーバーで、IISサービスとCitrixSsRecStorageManagerサービスが実行状態にあることを確認します。
Check whether the CitrixSmAudAgent, CitrixSmAudMsgQueue, and CitrixSmAudNatsServer services are in a running state on the VDA.

VDA上で動作するCitrixSmAudMsgQueueサービスが起動に失敗する

VDAに.NET 8 Runtimeがインストールされていることを確認します。
SessionRecordingMsgQueue.msiのインストール時に管理者権限があることを確認します。

MSMQサービスを停止できない、またはMSMQ機能を無効にできない

VDAで、レジストリ Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\CitrixSmAudAgent の DependOnService キーから MSMQ を削除し、残りは変更せずに、OK をクリックしてからVDAを再起動します。

インストールの自動化

Session Recordingは、オプション付きのサイレントインストールをサポートしています。

Session Recording管理コンポーネントのインストールの自動化

単一のコマンドを使用してSession Recording管理コンポーネントの完全なセットをインストールする

Session Recordingは、さまざまな種類のSQL認証をサポートするようになりました。詳細については、次の表を参照してください。

セッションレコーディングバージョン	サポートされているSQL Serverの種類	サポートされているSQL認証方法	注
< 2411	オンプレミスSQL Server アジュール SQL データベース Azure SQL マネージドインスタンス Azure 仮想マシン上の SQLサーバー AWS RDS グーグルクラウド SQL Server	SQLサーバー認証	詳細については、「クラウドSQLデータベースサービスにSession Recordingデータベースをインストールする」(https://docs.citrix.com/ja-jp/session-recording/current-release/install-upgrade-uninstall.html#install-the-session-recording-database-on-cloud-sql-database-services)を参照してください。





2411以降	オンプレミス SQL Server アジュール SQL データベースアジュール SQL マネージドインスタンス Azure仮想マシン上のSQLサーバー AWS RDS グーグルクラウド SQL Server	SQL サーバー認証クラウド管理のEntra IDアカウントを使用したMicrosoft Entra IDパスワード認証	Microsoft Entra ID パスワード認証は、Azure SQL Database および Azure SQL Managed Instance のみでサポートされています。詳細については、Azure SQL Database にセッション録画データベースをインストールするおよび Azure SQL Managed Instance または AWS RDS にセッション録画データベースをインストールするを参照してください。





2507以降	オンプレミスSQL Server アジュール SQL データベースアジュール SQL マネージドインスタンスアジュール仮想マシン上の SQL Server	SQLサーバー認証クラウド管理Entra IDアカウントによるMicrosoft Entra IDパスワード認証クラウド管理Entra IDアカウントによるMicrosoft Entra IDサービスプリンシパル認証	Microsoft Entra ID パスワード認証は、Azure SQL データベースおよび Azure SQL マネージドインスタンスのみをサポートします。マイクロソフトエントラ ID サービスプリンシパル認証は、アジュール SQL マネージドインスタンスのみをサポートします



	該当なし - AWS RDS グーグルクラウドエスキューエルサーバ
	該当なし - AWS RDS グーグルクラウドエスキューエルサーバ

たとえば、以下のいずれかのコマンドを実行すると、Session Recording Administration コンポーネントの完全なセットがインストールされ、インストール情報をキャプチャするためのログファイルが作成されます。

msiexec /i "c:\SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="WNBIO-SRD-1" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" DATABASEUSER="localhost" /q /l*vx "yourinstallationlog"
<!--NeedCopy-->

msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="DatabaseConnectionString" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" DATABASEUSER="localhost" CLOUDDBSUPPORT="0" AZUREUSERNAME="SQLorEntraIDAdminName" AZUREPASSWORD="SQLorEntraIDAdminPassword" AADPASSWORD="1" SERVICEKEYAUTHENABLE="1" /qn+ /l*vx "yourinstallationlog"
<!--NeedCopy-->

msiexec /i "SessionRecordingAdministrationx64.msi"
ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase"
DATABASEINSTANCE="DatabaseConnectionString" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1"
CLOUDDBSUPPORT="0"
AZUREUSERNAME="ServicePrincipalClientId" AZUREPASSWORD="ServicePrincipalClientsecret"
AADPASSWORD="0"
AZURETENANTID="ServicePrincipalTenantId"
SERVICEPRINCIPAL="1" /qn+ /l*vx "yourinstallationlog "
<!--NeedCopy-->

注:

SessionRecordingAdministrationx64.msi ファイルは、Citrix Virtual Apps and Desktops ISO の \x64\Session Recording にて見つけることが可能となっています。

ここで DATABASEINSTANCE で指定されたインスタンスに関係なく、2411 リリース以降、Session Recording 管理ログデータベースを Session Recording データベースとは別のインスタンスにインストールすることもできます。そのためには、いずれかのインストールコマンドを実行する前に、次の手順を完了してください。

Session Recording サーバーをインストールするマシンに移動します。

レジストリエディターを開きます。

レジストリを変更します:

HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Serverに移動します。

SmAudDatabaseLoggingState DWORD (32ビット) 値を追加し、値のデータを1に設定します。

SmAudDatabaseLoggingInstance値を追加し、値のデータを、Session Recording管理ログデータベースをインストールするインスタンス名に設定します。

後でデータベースをインストールするときに、Session Recording管理ログデータベースは、SmAudDatabaseLoggingInstanceレジストリ値で指定された別のインスタンスにインストールされます。両方のデータベースで同じ認証モード（SQL Server認証、Windows認証、またはMicrosoft Entra ID認証）を構成し、同じユーザー権限を付与する必要があります。

ここで:

ADDLOCALは、選択できる機能を提供します。複数のオプションを選択できます。SsRecServerはセッションレコーディングサーバーです。PolicyConsoleはセッションレコーディングポリシーコンソールです。SsRecLoggingは管理者ログ機能です。StorageDatabaseはセッションレコーディングデータベースです。セッションレコーディング管理者ログは、セッションレコーディングサーバーのオプションのサブ機能です。セッションレコーディング管理者ログを選択する前に、セッションレコーディングサーバーを選択してください。
DATABASEINSTANCEは、Session Recordingデータベースのインスタンス名です。たとえば、Azure SQL Managed Instanceを使用している場合は.\SQLEXPRESS,computer-name\SQLEXPRESS,computer-nameまたはtcp:srt-sql-support.public.ca7b16b60789.database.windows.net,3342です。前述のとおり、Session RecordingデータベースとSession Recording管理ログデータベースを同じインスタンスまたは別のインスタンスにインストールできます。
DATABASENAMEは、セッションレコーディングデータベースのデータベース名です。
LOGGINGDATABASENAMEは、管理者ログデータベースの名前です。
AZURESQLSERVICESUPPORTは、SQL Server認証がサポートされているかどうかを決定します。SQL Server認証を使用するには、1に設定します。
DATABASEUSERは、セッションレコーディングサーバーのコンピューターアカウントです。
CLOUDDBSUPPORTは、Azure SQLデータベースがサポートされているかどうかを決定します。
AZUREUSERNAME は、SQL Server または Microsoft Entra ID の管理者名、あるいは Microsoft Entra ID のサービスプリンシパルクライアント ID (アプリケーション ID) を表します。Microsoft Entra ID 認証を利用する場合は、以下の手順を実行してください。
1. Visual C++ RedistributableがSession Recordingサーバーにインストールされていることを確認してください。インストールされていない場合は、https://learn.microsoft.com/ja-jp/cpp/windows/latest-supported-vc-redist?view=msvc-170からダウンロードしてインストールしてください。
2. Session RecordingサーバーにMicrosoft ODBC Driver for SQL Serverがインストールされていることを確認してください。インストールされていない場合は、https://learn.microsoft.com/ja-jp/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-ver16からダウンロードしてインストールしてください。
3. データベースインストールコマンドを実行する際に、AADPASSWORDパラメーターを含め、その値を1に設定します。
4. Entra ID管理者を作成し、SQL Serverの管理権限を付与します。詳細については、Microsoftのドキュメントを参照してください: https://learn.microsoft.com/ja-jp/azure/azure-sql/database/authentication-aad-configure?view=azuresql&tabs=azure-powershell。
AZUREPASSWORD は、SQL Server または Microsoft Entra ID の管理者パスワード、あるいは Microsoft Entra ID のサービスプリンシパルクライアント秘密情報です。
AADPASSWORDは、Microsoft Entra ID認証がサポートされているかどうかを決定します。Microsoft Entra ID認証を使用するには、これを1に設定します。
AZURETENANTID は Azure のテナント識別子 (ディレクトリ識別子) です。
SERVICEPRINCIPAL は、Microsoft Entra ID サービスプリンシパル認証がサポートされているかどうかを決定します。Microsoft Entra ID サービスプリンシパル認証を使用するには、これを 1 に設定します。
SERVICEKEYAUTHENABLEは、Session RecordingエージェントとSession Recordingサーバー間のサービスキー認証を有効にします。このパラメーターは、Azure ADサポートを有効にする場合にのみ必要であり、1に設定する必要があります。それ以外の場合は、このパラメーターを追加しないでください。
/qはサイレントモードを指定します。
/l*vは詳細ログを有効にします。
yourinstallationlogは、インストールログファイルの場所です。

Session Recordingサーバーを展開するためのマスターイメージを作成する

既存の展開からSession Recordingデータベースと管理ログデータベースがすでに配置されている場合があります。このようなシナリオでは、SessionRecordingAdministrationx64.msiを使用してSession Recording管理コンポーネントをインストールする際に、データベースチェックを省略できるようになりました。Session Recordingサーバーを他の多くのマシンに簡単に展開するためのマスターイメージを作成できます。マスターイメージを使用してターゲットマシンにSession Recordingサーバーを展開した後、各マシンでコマンドを実行して、既存のSession Recordingデータベースと管理ログデータベースに接続します。このマスターイメージサポートは、展開を容易にし、人為的ミスの潜在的な影響を最小限に抑えます。これは新規インストールにのみ適用され、次の手順で構成されます。

コマンドプロンプトを起動し、次のようなコマンドを実行します。
```
msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="sqlnotexists" DATABASENAME="CitrixSessionRecording2" LOGGINGDATABASENAME="CitrixSessionRecordingLogging2" DATABASEUSER="localhost" /q /l*vx "c:\WithLogging.log" IGNOREDBCHECK="True"

```
このコマンドは、Session Recordingデータベースおよび管理ログデータベースへの接続を構成およびテストすることなく、Session Recording管理コンポーネントをインストールします。

Set the IGNOREDBCHECK parameter to True and use random values for DATABASEINSTANCE, DATABASENAME, and LOGGINGDATABASENAME.
操作しているマシンにマスターイメージを作成します。
セッション録画サーバーを展開するために、マスターイメージを他のマシンに展開します。
各マシンで、次のようなコマンドを実行します。
```
.\SsRecUtils.exe -modifydbconnectionpara DATABASEINSTANCE DATABASENAME LOGGINGDATABASENAME

iisreset /noforce

```
これらのコマンドは、以前にインストールされたセッション録画サーバーを、既存のセッション録画データベースおよび管理ログデータベースに接続します。

\Citrix\SessionRecording\Server\bin\でSsRecUtils.exeファイルを見つけることができます。必要に応じて、DATABASEINSTANCE、DATABASENAME、およびLOGGINGDATABASENAMEパラメーターを設定します。

セッション録画管理コンポーネントをアンインストールする際にデータベースを保持する

KEEPDBをTrueに設定すると、セッション録画管理コンポーネントをアンインストールする際に、次のコマンドによってセッション録画データベースと管理ログデータベースが保持されます。

msiexec /x "SessionRecordingAdministrationx64.msi" KEEPDB="True"
<!--NeedCopy-->

セッション録画プレーヤーとWebプレーヤーのインストールを自動化する

たとえば、次のコマンドはそれぞれセッション録画プレーヤーとWebプレーヤーをインストールします。

msiexec /i "c:\SessionRecordingPlayer.msi" /q /l*\vx "yourinstallationlog"
<!--NeedCopy-->

msiexec /i "c:\SessionRecordingWebPlayer.msi" /q /l*vx "yourinstallationlog"
<!--NeedCopy-->

注：

SessionRecordingPlayer.msiは、シトリックスバーチャルアプリケーションズアンドデスクトップス ISOの\x86\Session Recordingにあります。

SessionRecordingWebPlayer.msiは、シトリックスバーチャルアプリケーションズアンドデスクトップス ISOの\x64\Session Recordingにあります。

ここで：

/qはサイレントモードを指定します。
/l*v は詳細ログ記録を指定します。
yourinstallationlog は、インストールログファイルの場所です。

Session Recordingエージェントのインストールを自動化する

たとえば、次のコマンドはSession Recordingエージェントをインストールし、インストール情報をキャプチャするためのログファイルを作成します。

msiexec /i SessionRecordingAgentx64.msi /q /l*vx yourinstallationlog SESSIONRECORDINGSERVERNAME=yourservername
SESSIONRECORDINGBROKERPROTOCOL=yourbrokerprotocol SESSIONRECORDINGBROKERPORT=yourbrokerport SESSIONRECORDINGAUTHENTICATION="Citrix Cloud™" SESSIONRECORDINGRPC="Websocket" SESSIONRECORDINGIDP="IDP"
<!--NeedCopy-->

注：

SessionRecordingAgentx64.msiは、シトリックスバーチャルアプリケーションズアンドデスクトップス ISOの\x64\Session Recordingにあります。

ここで、

yourservername は、Session RecordingサーバーをホストするマシンのNetBIOS名またはFQDNです。指定しない場合、この値はデフォルトで localhost になります。
yourbrokerprotocol は、セッションレコーディングエージェントがセッションレコーディングブローカーと通信するために使用するHTTPまたはHTTPSです。指定しない場合、この値はデフォルトでHTTPSになります。
yourbrokerport は、Session RecordingエージェントがSession Recording Brokerと通信するために使用するポート番号です。指定しない場合、この値はデフォルトでゼロになり、Session Recordingエージェントは選択したプロトコル（HTTPの場合は80、HTTPSの場合は443）のデフォルトポート番号を使用するように指示されます。
SESSIONRECORDINGAUTHENTICATION は、Session RecordingエージェントとSession Recordingサーバー間の認証タイプです。このパラメーターは、Azure ADサポートを有効にする場合にのみ必要です。Azure ADサポートを有効にするには、このパラメーターを追加し、Citrix Cloud に設定します。
SESSIONRECORDINGRPC は、Session RecordingエージェントとSession Recordingサーバー間の通信方法です。このパラメーターは、Azure ADサポートを有効にする場合にのみ必要です。Azure ADサポートを有効にするには、このパラメーターを追加し、Websocket に設定します。
SESSIONRECORDINGIDP は、IDタイプを指定します。このパラメーターは、Azure ADサポートを有効にする場合にのみ必要です。Azure ADサポートを有効にするには、このパラメーターを追加し、IDP に設定します。
/q はサイレントモードを指定します。
/l*v は詳細ログ記録を指定します。
yourinstallationlog は、インストールログファイルの場所です。

セッションレコーディングのアップグレード

特定の展開を、新しいマシンやサイトを最初にセットアップすることなく、以降のバージョンにアップグレードできます。XenAppおよびXenDesktop 7.6 LTSRの最新CUに含まれるSession Recordingのバージョン、およびそれ以降の任意のバージョンから、Session Recordingの最新リリースにアップグレードできます。

注：

Session Recording Administrationを7.6から7.13以降にアップグレードし、Session Recording Administrationで変更を選択して管理者ログサービスを追加すると、SQL Serverインスタンス名が管理者ログ構成ページに表示されません。次へをクリックすると、次のエラーメッセージが表示されます: データベース接続テストに失敗しました。正しいデータベースインスタンス名を入力してください。 回避策として、localhostユーザーに次のSmartAuditor Serverレジストリフォルダーへの読み取り権限を追加してください: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server。

テクニカルプレビューバージョンからアップグレードすることはできません。

要件、準備、および制限

Session Recordingコンポーネントをインストールしたマシンで、Session Recordingインストーラーのグラフィカルインターフェイスまたはコマンドラインインターフェイスを使用して、Session Recordingコンポーネントをアップグレードします。
アップグレード作業を行う前に、SQL Serverインスタンス内のCitrixSessionRecordingという名前のデータベースをバックアップしてください。これにより、データベースのアップグレード後に問題が発見された場合に復元できます。
ドメインユーザーであることに加えて、Session Recordingコンポーネントをアップグレードするマシンではローカル管理者である必要があります。
Session RecordingサーバーとSession Recordingデータベースが同じサーバーにインストールされていない場合、Session Recordingデータベースをアップグレードするにはデータベースロール権限が必要です。そうでない場合は、次のいずれかの方法で対応できます。
- データベース管理者に、アップグレードのためにsecurityadminおよびdbcreatorサーバーロール権限を割り当てるよう依頼します。アップグレードが完了した後、securityadminおよびdbcreatorサーバーロール権限は不要になり、安全に削除できます。
- または、SessionRecordingAdministrationx64.msiパッケージを使用してアップグレードします。msiアップグレード中に、securityadminおよびdbcreatorサーバーロール権限を持つデータベース管理者の資格情報を求めるダイアログボックスが表示されます。正しい資格情報を入力し、OKをクリックしてアップグレードを続行します。
すべてのSession Recordingエージェントを同時にアップグレードしないことを選択できます。Session Recordingエージェント7.6.0（およびそれ以降）は、Session Recordingサーバーの最新（現行）リリースと互換性があります。ただし、一部の新機能やバグ修正は有効にならない場合があります。
Session Recordingサーバーのアップグレード中に開始されたセッションは記録されません。
Session Recordingエージェントのプロパティにあるグラフィック調整オプションは、新規インストールまたはアップグレード後に、デスクトップコンポジションリダイレクトモードとの互換性を維持するためにデフォルトで有効になっています。新規インストールまたはアップグレード後に、このオプションを手動で無効にすることができます。
管理者ログ機能は、その機能が利用できない以前のリリースからSession Recordingをアップグレードした後にはインストールされません。この機能を追加するには、アップグレード後にインストールを変更してください。
アップグレードプロセス開始時にライブ録画セッションがある場合、録画が完了する可能性はほとんどありません。
潜在的な停止を計画し、軽減できるように、次のアップグレードシーケンスを確認してください。

アップグレードシーケンス

既存のインストールをアップグレードするには、Session Recordingコンポーネントがインストールされている各マシンに移動し、Citrix Virtual Apps and Desktops ISOを実行します。

ヒント:

シトリックスバーチャルアプリアンドデスクトップの適切なバージョンをダウンロードするには、シトリックスバーチャルアプリアンドデスクトップのダウンロードページにアクセスしてください。

既存のインストールをアップグレードする場合、通常、次のシーケンスに従います。

Session Recordingサーバーコンポーネントをアップグレードします。

Session Recordingサーバーが複数ある場合、まずSession Recordingデータベースコンポーネントがインストールされているサーバーをアップグレードします。その後、残りのSession Recordingサーバーをアップグレードします。

そのためには、次の手順を実行します。
1. セッションレコーディングサーバー上で、セッションレコーディングストレージマネージャーサービスを手動で停止します。
2. インターネットインフォメーションサービス (IIS) マネージャーを通じて、セッションレコーディングブローカーが実行されていることを確認します。
3. シトリックスバーチャルアプリケーションズアンドデスクトップス ISO を実行し、アップグレードするセッションレコーディングエントリを選択します。
Session Recordingサーバーのアップグレードが完了すると、Session Recordingサービスは自動的にオンラインに戻ります。
Session Recordingエージェント（マスターイメージ上）をアップグレードします。
Session Recordingサーバーと同時またはその後に、Session Recordingポリシーコンソールをアップグレードします。
Session Recordingプレーヤーをアップグレードします。

バージョン2511へのアップグレードに関する重要な注意点：

Session Recordingエージェントのアップグレードが不完全なことによるセッション記録の失敗を防ぐため、2511にアップグレードする際は以下の手順に従ってください。

各Session Recordingサーバーをバージョン2511にアップグレードします。

次のコマンドを使用して、.NET Remotingによるリモートアクセスを有効にします。

<SessionRecordingserverinstallationpath>\Bin\SsRecUtils.exe -EnableBrokerRemoting

各Session Recordingエージェントをバージョン2511にアップグレードします。

すべてのSession Recordingエージェントがアップグレードされたら、次のコマンドを使用して、.NET Remotingによるリモートアクセスを無効にします。

<SessionRecordingserverinstallationpath>\Bin\SsRecUtils.exe -DisableBrokerRemoting

クラウドSQLデータベースサービスへのSession Recordingデータベースのインストール

このセクションでは、以下のクラウドSQLデータベースサービスにSession Recordingデータベースをインストールする方法について説明します。

アジュール SQL データベース
Azure SQL マネージドインスタンス
Azure仮想マシン上のSQLサーバー
AWS RDS (アールディーエス)
グーグルクラウド SQL Server

Azure SQL Database にセッションレコーディングデータベースをインストールする

Azure SQLデータベースを作成します。
1. Azure アカウントを使用して Azure ポータルにサインインします。
2. ポータルメニューから「リソースの作成」を選択します。
3. ポータルの検索ボックスに「SQL database」と入力します。
4. 検索結果のリストから「SQL databases」を選択します。
5. Azure SQL Database を作成するには、「作成」をクリックします。
6. 「SQL Database の作成」セクションで、次の情報を入力します。
  - 「サブスクリプション」: 目的の Azure サブスクリプションを選択します。
  - 「リソースグループ」: 「新規作成」を選択するか、既存のリソースグループを選択します。
  - 「データベース名」: 一意の名前が必要です。
  - サーバー: 「新規作成」を選択し、次の値を指定して新しいサーバーフォームに記入します。
    - サーバー名: 一意の名前を入力します。サーバー名は、Azure内のすべてのサーバーでグローバルに一意である必要があります。
    - 場所: ドロップダウンリストから場所を選択します。
    - 認証方法: SQL認証、Entra ID認証、またはその両方を使用するを選択します。
    - サーバー管理者ログイン: SQL ServerまたはMicrosoft Entra ID管理者名を入力します。2411以降、Session Recordingは、Azure SQL DatabaseおよびAzure SQL Managed Instanceを含むクラウドベースのSQLデータベースのEntra ID認証をサポートします。Microsoft Entra ID認証の詳細については、この記事のコマンドパラメーターの説明を参照してください。
    - パスワード: 要件を満たすSQL ServerまたはMicrosoft Entra ID管理者パスワードを入力し、パスワードの確認フィールドにもう一度入力します。
    - OKを選択します。
  上記の情報を提供した後、「確認 + 作成」をクリックします。「作成」ボタンをクリックしてAzure SQL Databaseを完了します。
手順1を繰り返して、同じサーバー上に別のAzure SQL Databaseを作成します。
作成したAzure SQL Databaseのサーバー接続文字列を取得します。
1. Azureポータルで、作成したAzure SQL Databaseのいずれかを検索してクリックします。
2. 左側のナビゲーションから「接続文字列」をクリックします。
3. 後でSession RecordingデータベースおよびSession Recordingログデータベースのインスタンス名として使用されるサーバー文字列を記録しておきます。
以前に作成したAzure SQL DatabaseにSession Recordingデータベースをインストールするには、次のようなコマンドを実行します。

注:

Azure SQL Databaseでは、セッションレコーディングデータベースのインストールは、以下のコマンドを実行することによってのみ可能です。

msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="DatabaseConnectionString" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" DATABASEUSER="localhost" CLOUDDBSUPPORT="1" AZUREUSERNAME="SQLorEntraIDAdminName" AZUREPASSWORD="SQLorEntraIDAdminPassword" AADPASSWORD="1" /qn+ /l*vx "yourinstallationlog"

各項目の説明:
- ADDLOCAL は、選択する機能を提供します。複数のオプションを選択できます。SsRecServer はセッションレコーディングサーバーです。PolicyConsole はセッションレコーディングポリシーコンソールです。SsRecLogging は管理者ログ機能です。StorageDatabase はセッションレコーディングデータベースです。セッションレコーディング管理者ログは、セッションレコーディングサーバーのオプションのサブ機能です。セッションレコーディング管理者ログを選択する前に、セッションレコーディングサーバーを選択してください。
- DATABASEINSTANCE は、Azure SQL Database接続文字列によって指定される、セッションレコーディングデータベースのインスタンス名です。
- DATABASENAME は、セッションレコーディングデータベースのデータベース名です。
- LOGGINGDATABASENAME は、管理者ログデータベースの名前です。
- AZURESQLSERVICESUPPORT は、SQL Server認証がサポートされているかどうかを決定します。SQL Server認証を使用するには、これを1に設定します。
- CLOUDDBSUPPORT は、Azure SQL Databaseがサポートされているかどうかを決定します。
- DATABASEUSER は、セッションレコーディングサーバーのコンピューターアカウントです。
- AZUREUSERNAME は、SQL ServerまたはMicrosoft Entra ID管理者名です。2411以降、セッションレコーディングは、Azure SQL DatabaseおよびAzure SQL Managed Instanceを含むクラウドベースのSQLデータベースに対するEntra ID認証をサポートしています。Microsoft Entra ID認証を使用するには、次の手順を完了します。
  1. Visual C++ Redistributableがセッションレコーディングサーバーにインストールされていることを確認してください。インストールされていない場合は、https://learn.microsoft.com/ja-jp/cpp/windows/latest-supported-vc-redist?view=msvc-170からダウンロードしてインストールしてください。
  2. Microsoft ODBC Driver for SQL Serverがセッションレコーディングサーバーにインストールされていることを確認してください。インストールされていない場合は、https://learn.microsoft.com/ja-jp/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-ver16からダウンロードしてインストールしてください。
  3. データベースインストールコマンドを実行する際に、AADPASSWORD パラメーターを含め、1に設定します。
  4. Entra ID管理者を作成し、SQL Server管理権限を付与します。詳細については、Microsoftドキュメントを参照してください: https://learn.microsoft.com/ja-jp/azure/azure-sql/database/authentication-aad-configure?view=azuresql&tabs=azure-powershell。
- AZUREPASSWORD is the SQL Server or Microsoft Entra ID administrator password.
- AADPASSWORD は、Microsoft Entra ID 認証がサポートされているかどうかを決定します。Microsoft Entra ID 認証を使用するには、これを 1 に設定します。
- /q は、サイレントモードを指定します。
- /l*v は、詳細ログ記録を指定します。
- yourinstallationlog は、インストールログファイルの場所です。

Azure SQL マネージドインスタンスまたは AWS RDS にセッションレコーディングデータベースをインストールする

ヒント:

Azure SQL Managed Instance および AWS RDS では、セッションレコーディングデータベースを次の方法でインストールできます。
SessionRecordingAdministrationx64.msi インストールパッケージをダブルクリック操作を実行し、起動します。
次のようなコマンドを実行する。
 msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="DatabaseConnectionString "DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" CLOUDDBSUPPORT="1" AZUREUSERNAME="SQLorEntraIDAdminName" AZUREPASSWORD="SQLorEntraIDAdminPassword" AADPASSWORD="1"/qn+ /l*vx "yourinstallationlog"

Azure SQL Managed Instance を作成するか、Amazon RDS コンソールを使用して SQL Server インスタンスを作成してください。
(Azure SQL のみ) プロパティパネルに表示される Server 文字列を記録しておきます。これらの文字列は、Session Recording データベースのインスタンス名です。例については、次のスクリーンショットを参照してください。
(AWS RDS のみ) Endpoint および Port の情報を記録しておきます。これは、データベースのインスタンス名として、<Endpoint, Port> の形式で使用します。
セッションレコーディングデータベースをインストールするには、SessionRecordingAdministrationx64.msi を実行します。

SQL Server認証を有効にするチェックボックスをオンにし、SQL Server管理者名とパスワードを入力します。その他の必要な構成を行います。

SQL Server管理者資格情報を入力します(/ja-jp/session-recording/current-release/media/cloud-sql-admin-credentials.png)
注：
- SQL Server管理者のパスワードを変更した場合は、Session Recording Serverのプロパティでパスワードを更新する必要があります。Session Recording Serverのプロパティを開くと、エラーメッセージが表示されます。OKをクリックして続行し、Cloud DBタブを選択して、新しいSQL Server管理者のパスワードを入力します。Citrix Session Recording Analyticsサービス、Citrix Session Recording Storage Managerサービス、およびIISサービスを再起動します。 SQL Server管理者パスワードを更新します(/ja-jp/session-recording/current-release/media/updating-cloud-sql-admin-password.png)
- SQL Server認証に加えて、Session Recordingは、Azure SQL DatabaseやAzure SQL Managed InstanceなどのクラウドベースのSQLデータベースに対するEntra ID（旧Azure Active Directory）認証をサポートしています。Microsoft Entra ID認証を使用するには、コマンドラインからデータベースをインストールし、この記事で前述した手順に従ってください。
- Azure AD認証はサポートされていません。

オンプレミスデータベースをクラウドSQL Managed Instanceに移行する

https://docs.microsoft.com/ja-jp/data-migration/またはhttps://docs.aws.amazon.com/prescriptive-guidance/latest/patterns/migrate-an-on-premises-microsoft-sql-server-database-to-amazon-rds-for-sql-server.htmlに従って、オンプレミスデータベースを移行します。
移行後にSession Recordingが正しく機能するようにするためには、Session Recordingサーバー上でSsRecUtils.exeを実行してください。

C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -modifyazuredbconnectionpara {Database Instance} {Session Recording Database Name} {Session Recording Logging Database Name} {AzureAdminName}{AzureAdminPassword} iisreset /noforce
セッションレコーディングサーバー上で、シトリックスセッションレコーディングアナリティクスサービス、シトリックスセッションレコーディングストレージマネージャーサービス、およびIISサービスを再起動します。

Azure SQL Managed Instanceからオンプレミスデータベースに本番データベースを移行する

https://docs.microsoft.com/ja-jp/data-migration/に従ってデータベースを移行します。
移行後にセッションレコーディングが正常に動作するようにするには、セッションレコーディングサーバーでSsRecUtils.exeを実行します。

C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -modifydbconnectionpara {Database Instance} {Session Recording Database Name} {Session Recording Logging Database Name} iisreset /noforce
セッションレコーディングサーバーで、Citrix セッションレコーディング Analytics サービス、Citrix セッションレコーディング Storage Manager サービス、およびIISサービスを再起動します。

Azure 仮想マシン上のエスキューエルサーバーにセッションレコーディングデータベースをインストールする

Azure 仮想マシン上のエスキューエルサーバーでは、セッションレコーディングデータベースを SessionRecordingAdministrationx64.msi パッケージをダブルクリックして実行するか、Citrix Virtual Apps and Desktops インストーラーを使用してインストールできます。

Azure SQL VMをチェックアウトします。
VMを構成し、Session Recordingコンポーネントをインストールするドメインに追加します。
Session Recordingデータベースのインストール中に、VMのFQDNをインスタンス名として使用します。注： SessionRecordingAdministrationx64.msiを使用してインストールする場合は、［SQL Server認証を有効にする］チェックボックスをオフにします。
インストールユーザーインターフェイスに従って、Session Recordingデータベースのインストールを完了します。

Google Cloud SQL Server にセッションレコーディングデータベースをインストールする

ヒント：

Google Cloud SQL Serverでは、Session Recordingデータベースのインストールは、次のようなコマンドを実行するか、SessionRecordingAdministrationx64.msiパッケージをダブルクリックして実行することで行うことができます。コマンドパラメーターの説明については、この記事の前の「自動インストール」セクションを参照してください。
msiexec /i "SessionRecordingAdministrationx64.msi" ADDLOCAL="SsRecServer,PolicyConsole,SsRecLogging,StorageDatabase" DATABASEINSTANCE="CloudSQL" DATABASENAME="CitrixSessionRecording" LOGGINGDATABASENAME="CitrixSessionRecordingLogging" AZURESQLSERVICESUPPORT="1" AZUREUSERNAME="CloudSQLAdminName" AZUREPASSWORD="CloudSQLAdminPassword" /q /l*vx "c:\WithLogging.log"

このセクションでは、Citrix Virtual Apps and Desktops ISO の \x64\セッションレコーディング にある SessionRecordingAdministrationx64.msi を使用したインストール方法について詳しく説明します。

Google Cloud上にSQLサーバーのインスタンスを作成します。
1. Google Cloudコンソールに移動し、SQLインスタンスページを開きます。
2. ［インスタンスを作成］をクリックします。例：
  
  Google Cloudでインスタンスを作成する(/ja-jp/session-recording/current-release/media/create-instance-in-google-cloud.png)
3. データベースエンジンとしてSQL Serverを選択します。
  
  データベースエンジンとしてSQL Serverを選択する(/ja-jp/session-recording/current-release/media/choose-database-engine.png)
4. インスタンスIDフィールドに入力し、ユーザーのパスワードを入力します。パスワードを記録しておきます。インスタンスのSQL Serverバージョンを選択します。必要に応じてその他の構成を行います。例:
  
  インスタンスIDなどを構成する(/ja-jp/session-recording/current-release/media/configure-instance-id-and-others.png)
5. インスタンスにパブリックIPアドレスを割り当て、インスタンスに接続できる承認済みネットワークを設定します。ネットワークフィールドに、Session RecordingサーバーがインストールされているマシンのIPアドレスを入力します。例:
  
  パブリックIPアドレスとネットワークを割り当てる(/ja-jp/session-recording/current-release/media/public-ip-address-and-network.png)
6. CREATE INSTANCEをクリックし、数分間待ちます。
  
  インスタンスの概要(/ja-jp/session-recording/current-release/media/instance-summary.png)
7. 新しく作成されたインスタンスのページで、パブリックIPアドレスを見つけて記録しておきます。
  
  パブリックIPアドレスを記録する(/ja-jp/session-recording/current-release/media/generated-public-ip-address.png)
8. SessionRecordingAdministrationx64.msiを実行して、セッションレコーディングデータベースをインストールします。
  
  インストール中の次のページで、次の構成を行います。
  - SQL Server認証を有効にするチェックボックスをオンにします。
  - インスタンス名フィールドに、以前に作成したSQL ServerインスタンスのパブリックIPアドレスを入力します。
  - SQL Server管理者名とパスワードを入力します。
  SQL Server管理者資格情報を入力します(/ja-jp/session-recording/current-release/media/cloud-sql-admin-credentials.png)

セッションレコーディングのアンインストール

サーバーまたはワークステーションからSession Recordingコンポーネントを削除するには、Windowsのコントロールパネルにあるアンインストールまたはプログラムの削除オプションを使用します。 Session Recordingデータベースを削除するには、インストール時と同じsecurityadminおよびdbcreator SQL Serverロール権限が必要です。

セキュリティ上の理由から、コンポーネントのアンインストール後も管理者ログデータベースは削除されません。

シトリックスアナリティクスフォーセキュリティ™ と統合する

Session Recordingサーバーを構成して、ユーザーイベントをCitrix Analytics for Securityに送信できます。Citrix Analytics for Securityは、ユーザーイベントを処理して、ユーザーの行動に関する実用的な洞察を提供します。

前提条件

開始する前に、以下を確認してください。

Session Recordingサーバーは、次のアドレスに接続できる必要があります。
Session Recording展開では、送信インターネット接続用にポート443が開いている必要があります。ネットワーク上のプロキシサーバーは、Citrix Analytics for Securityとのこの通信を許可する必要があります。
Citrix Virtual Apps and Desktops 7 1912 LTSRを使用している場合、サポートされるセッションレコーディングのバージョンは2103以降です。

お使いのセッション録画サーバーをCitrix Analytics for Securityに接続する

Citrix Cloudにサインインします。
Citrix Analytics for Securityを見つけて、[管理] をクリックしてください。
上部のバーから、[設定] > [データソース] をクリックします。
[Virtual Apps and Desktops - Session Recording] サイトカードで、[セッション録画サーバーの接続] をクリックします。

セッション録画接続(/ja-jp/session-recording/current-release/media/sr-connect-new-tenant.png)
[セッション録画サーバーの接続] ページで、チェックリストを確認し、必須要件をすべて選択します。必須要件を選択しない場合、[ファイルのダウンロード] オプションは無効になります。

セッション録画チェックリスト(/ja-jp/session-recording/current-release/media/sr-checklist.png)
ネットワークにプロキシサーバーがある場合は、セッション録画サーバーの SsRecStorageManager.exe.config ファイルにプロキシアドレスを入力します。

構成ファイルは<SessionRecordingserverinstallationpath>\bin\SsRecStorageManager.exe.configにあります。

例: C:\Program Files\Citrix\SessionRecording\Server\Bin\SsRecStorageManager.exe.config

構成ファイルのパス(/ja-jp/session-recording/current-release/media/sr-config-file-path.png)
[ファイルのダウンロード] をクリックして、SessionRecordingConfigurationFile.json ファイルをダウンロードします。

注:

このファイルには機密情報が含まれています。安全な場所に保管してください。
Citrix Analytics for Securityに接続したいセッションレコーディングサーバーにファイルをコピーします。
展開環境に複数のセッションレコーディングサーバーがある場合は、接続したい各サーバーにファイルをコピーし、各サーバーを構成する手順に従う必要があります。

セッションレコーディングサーバーで、次のコマンドを実行して設定をインポートします。

<SessionRecordingserverinstallationpath>\bin\SsRecUtils.exe -Import_SRCasConfigurations <configuration file path>
<!--NeedCopy-->

例えば、次のとおりです。

C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -Import_SRCasConfigurations C:\Users\administrator\Downloads\SessionRecordingConfigurationFile.json
<!--NeedCopy-->

次のサービスを再起動します。
- シトリックスセッションレコーディングアナリティクスサービス
- シトリックスセッションレコーディングストレージマネージャー
構成が成功したら、Citrix Analytics for Securityに移動して、接続されているセッションレコーディングサーバーを表示します。Turn On Data Processingをクリックして、Citrix Analytics for Securityがデータを処理できるようにします。

注:

Session Recordingサーバーバージョン2103または2104を使用している場合、Citrix Analytics for Securityで接続されているSession Recordingサーバーを表示するには、まずVirtual Apps and Desktopsセッションを起動する必要があります。そうしないと、接続されているSession Recordingサーバーが表示されません。この要件は、Session Recordingサーバーバージョン2106以降には適用されません。

接続されている展開環境を表示する

サーバー展開環境は、構成が成功した場合にのみSession Recordingサイトカードに表示されます。サイトカードには、Citrix Analytics for Securityとの接続を確立した構成済みサーバーの数が表示されます。

構成が成功した後でもSession Recordingサーバーが表示されない場合は、トラブルシューティングセクションの構成済みSession Recordingサーバーが接続に失敗するを参照してください。

セッションレコーディング展開

サイトカードで、展開環境の数をクリックして、Citrix Analytics for Securityに接続されているサーバーグループを表示します。たとえば、1 Session Recording Deploymentをクリックして、接続されているサーバーまたはサーバーグループを表示します。各Session Recordingサーバーは、ベースURLとServerGroupIDで表されます。

SR展開の詳細

受信したイベントを表示

サイトカードには、接続されているSession Recording展開と、これらの展開から過去1時間に受信したイベントが表示されます。これはデフォルトの時間選択です。1週間 (1 W) を選択してデータを表示することもできます。受信したイベントの数をクリックすると、セルフサービス検索ページでイベントを表示できます。

データ処理を有効にすると、サイトカードにデータが受信されていませんというステータスが表示されることがあります。このステータスが表示される理由は2つあります。

初めてデータ処理をオンにした場合、イベントがCitrix Analyticsのイベントハブに到達するまでに時間がかかります。Citrix Analyticsがイベントを受信すると、ステータスはデータ処理オンに変わります。しばらくしてもステータスが変わらない場合は、データソースページを更新してください。
Citrix Analyticsが過去1時間にデータソースからイベントを受信していません。

セッションレコーディングサーバーを追加する

Session Recordingサーバーを追加するには、次のいずれかの操作を行います。

接続済みセッションレコーディング展開ページで、セッションレコーディングサーバーに接続をクリックします。
Virtual Apps and Desktops - セッションレコーディングサイトカードで、縦の省略記号 (⋮) をクリックし、Connect Session Recording serverを選択します。

構成ファイルをダウンロードし、Session Recordingサーバーを構成する手順に従います。

セッションレコーディングサーバーを削除する

セッションレコーディングサーバーを削除するには：

シトリックスアナリティクスフォーセキュリティで、接続済みセッションレコーディング展開 ページに移動し、削除するサーバー展開を選択します。
縦の省略記号 (⋮) をクリックし、アナリティクスからセッションレコーディングサーバーを削除 を選択します。

セッション録画サーバーを削除(/ja-jp/session-recording/current-release/media/sr-remove.png)

Citrix Analytics から削除したセッション録画サーバーで、次のコマンドを実行します。

<SessionRecordingserverinstallationpath>\bin\SsRecUtils.exe -Remove_SRCasConfigurations
<!--NeedCopy-->

例えば:

C:\Program Files\Citrix\SessionRecording\Server\bin\SsRecUtils.exe -Remove_SRCasConfigurations
<!--NeedCopy-->

データソースでのデータ処理の有効化または無効化

特定のデータソース（DirectorおよびWorkspaceアプリ）のデータ処理はいつでも停止できます。データソースサイトカードで、縦の省略記号 (⋮) をクリックし、Turn off data processing を選択します。Citrix Analytics は、そのデータソースのデータ処理を停止します。Virtual Apps and Desktops サイトカードからデータ処理を停止することもできます。このオプションは、DirectorとWorkspaceアプリの両方のデータソースに適用されます。データ処理を再度有効にするには、Turn On Data Processing をクリックします。

構成済みのセッション録画サーバーが接続に失敗する

構成後、セッション録画サーバーがCitrix Analyticsに接続できません。そのため、構成済みのサーバーがSession Recordingサイトカードに表示されません。

この問題をトラブルシューティングするには、次の手順を実行します。

構成済みのセッション録画サーバーで、次のPowerShellコマンドを実行してクライアントマシン識別 (CMID) を確認します。
```
Get-WmiObject -class SoftwareLicensingService | select Clientmachineid

```

CMIDが空の場合、指定されたパスに次のレジストリファイルを追加します。

レジストリ名	レジストリパス	キーの種類	値
`AuditorUniqueID`	`Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server\`	文字列	UUIDを入力します。
`EnableCASUseAuditorUniqueID`	`Computer/HKEY_LOCAL_MACHINE/SOFTWARE/Citrix/SmartAuditor/Server/`	レグ_Dワード	1

次のサービスを再起動します。
- シトリックスセッションレコーディングアナリティクスサービス
- シトリックスセッションレコーディングストレージマネージャー

この製品ドキュメントの正式なバージョンは英語版です。英語以外のすべてのバージョンは、お客様の利便性のためにのみ提供され、機械翻訳された内容が含まれている場合があります。詳しくは、Cloud Software Group home で機械翻訳に関する免責事項（Machine Translation Disclaimer）をご覧ください。

この情報は役に立ちましたか?

インストール、アップグレード、アンインストール

August 1, 2026

寄稿者:

C C

August 1, 2026

寄稿者:

C C

この記事の概要

インストールチェックリスト
（msiインストールの場合のみ必須）Citrixスクリプトを使用してWindowsの役割と機能の前提条件をインストールする
Citrix Virtual Apps and Desktopsインストーラーを使用したセッション録画のインストール
メッセージキューイングソリューションを選択する
- エムエスエムキュー
- セッションレコーディングメッセージキュー
インストールの自動化
- Session Recording管理コンポーネントのインストールの自動化
- セッション録画プレーヤーとWebプレーヤーのインストールを自動化する
セッションレコーディングのアップグレード
- 要件、準備、および制限
- アップグレードシーケンス
クラウドSQLデータベースサービスへのSession Recordingデータベースのインストール
セッションレコーディングのアンインストール
シトリックスアナリティクスフォーセキュリティ™ と統合する

この情報は役に立ちましたか?

インストール、アップグレード、アンインストール

インストールチェックリスト

（msiインストールの場合のみ必須）Citrixスクリプトを使用してWindowsの役割と機能の前提条件をインストールする

Citrix Virtual Apps and Desktopsインストーラーを使用したセッション録画のインストール

Session Recording管理コンポーネントをインストールする

ステップ1：製品ソフトウェアをダウンロードしてウィザードを起動する

ステップ2：インストールする製品を選択する

ステップ3：セッションレコーディングを選択する

ステップ4：ライセンス契約を読んで同意する

ステップ5：インストールするコンポーネントとインストール場所を選択する

ステップ6：インストールする機能を選択する

手順6.1：Session Recordingサーバー、データベース、および管理者ログのインストール

手順6.2：Session Recordingポリシーコンソールをインストールする

Step 7: Install Broker_PowerShellSnapIn_x64.msi

Session Recordingエージェントをインストールする

手順1：製品ソフトウェアをダウンロードしてウィザードを起動する

ステップ2：インストールする製品を選択する

ステップ3：セッションレコーディングを選択します

ステップ4：ライセンス契約を読んで同意する

ステップ5：インストールするコンポーネントとインストール場所を選択する

ステップ6：エージェント構成を指定する

手順7：前提条件を確認し、インストールを確定する

ステップ8：インストールの完了

Session Recording プレイヤーをインストールする

ステップ 1: 製品ソフトウェアをダウンロードしてウィザードを起動する

ステップ 2: インストールする製品を選択する

ステップ 3: セッションレコーディングを選択します

ステップ 4: ライセンス契約を読んで同意する

ステップ 5: インストールするコンポーネントとインストール場所を選択する

ステップ6：前提条件を確認し、インストールを確定する

ステップ7：インストールを完了する

メッセージキューイングソリューションを選択する

エムエスエムキュー

セッションレコーディング メッセージキュー

セッション記録メッセージキューのインストールと構成

オプションの構成

SSL暗号化の使用

トラブルシューティング

通信の不具合

VDA上で動作するCitrixSmAudMsgQueueサービスが起動に失敗する

MSMQサービスを停止できない、またはMSMQ機能を無効にできない

インストールの自動化

Session Recording管理コンポーネントのインストールの自動化

単一のコマンドを使用してSession Recording管理コンポーネントの完全なセットをインストールする

Session Recordingサーバーを展開するためのマスターイメージを作成する

セッション録画管理コンポーネントをアンインストールする際にデータベースを保持する

セッション録画プレーヤーとWebプレーヤーのインストールを自動化する

Session Recordingエージェントのインストールを自動化する

セッションレコーディングのアップグレード

要件、準備、および制限

アップグレードシーケンス

クラウドSQLデータベースサービスへのSession Recordingデータベースのインストール

Azure SQL Database にセッションレコーディングデータベースをインストールする

Azure SQL マネージド インスタンス または AWS RDS に セッションレコーディング データベースをインストールする

オンプレミスデータベースをクラウドSQL Managed Instanceに移行する

Azure SQL Managed Instanceからオンプレミスデータベースに本番データベースを移行する

Azure 仮想マシン上の エスキューエルサーバー に セッションレコーディングデータベースをインストールする

Google Cloud SQL Server にセッションレコーディングデータベースをインストールする

セッションレコーディングのアンインストール

シトリックス アナリティクス フォー セキュリティ™ と統合する

前提条件

お使いのセッション録画サーバーをCitrix Analytics for Securityに接続する

接続されている展開環境を表示する

受信したイベントを表示

セッションレコーディングサーバーを追加する

セッションレコーディングサーバーを削除する

データソースでのデータ処理の有効化または無効化

構成済みのセッション録画サーバーが接続に失敗する

この記事の概要

セッションレコーディングメッセージキュー

Azure SQL マネージドインスタンスまたは AWS RDS にセッションレコーディングデータベースをインストールする

Azure 仮想マシン上のエスキューエルサーバーにセッションレコーディングデータベースをインストールする

シトリックスアナリティクスフォーセキュリティ™ と統合する