エージェント

最終公開日 : Nov 13, 2026
Related information
インストールと構成

エージェントのインストールと構成

注:
  • インフラストラクチャサーバーにWorkspace Environment Management™ (WEM) エージェントをインストールしないでください。
  • WEMエージェントと管理コンソールを同じマシンにインストールしないでください。
  • 管理コンソールからWEMのアプリケーションショートカットとしてCitrix StoreFrontストアで公開されているリソースを割り当てる場合は、管理コンソールとエージェントホストマシンにCitrix Workspaceアプリ for Windowsがインストールされていることを確認してください。詳細については、「システム要件」を参照してください。

ステップ1：グループポリシーの構成（オプション）

オプションで、Agent Group Policies管理用テンプレートを使用して、エージェントのグループポリシーを構成できます。WEMインストールパッケージにはこのテンプレートが含まれています。テンプレートファイルは、.admxファイルと、言語固有の.admlファイルに分かれています。グループポリシーはドメインコントローラーで構成することをお勧めします。
エージェントホスト構成ポリシーを追加するには、次の手順を実行します。
  1. WEMインストールパッケージに含まれているAgent Group PoliciesフォルダーをWEMドメインコントローラーにコピーします。
  2. .admxファイルを追加します。
    1. Agent Group Policies > ADMXフォルダーに移動します。
    2. 2つのファイル（Citrix Workspace Environment Management Agent Host Configuration.admxとCitrixBase.admx）をコピーします。
    3. <C:\Windows>\PolicyDefinitionsフォルダーに移動し、ファイルを貼り付けます。
  3. .admlファイルを追加します。
    1. Agent Group Policies > ADMX > en-USフォルダーに移動します。
    2. 2つのファイル（Citrix Workspace Environment Management Agent Host Configuration.adml および CitrixBase.adml）をコピーします。
    3. <C:\Windows>\PolicyDefinitions\en-USフォルダーに移動し、ファイルを貼り付けます。
  4. グループポリシー管理エディターウィンドウで、コンピューターの構成 > ポリシー > 管理用テンプレート > Citrix コンポーネント > Workspace Environment Management > エージェントホストの構成に移動し、次の設定を構成します。
グループポリシー管理エディター
基本展開のカスタム設定。展開に使用されるカスタマイズされたエージェント設定。基本展開で利用可能なエージェント設定の詳細については、「基本展開エージェントの管理」を参照してください。
基本展開のWEMカスタム設定
エージェント展開の種類を上書き。WEMエージェントの展開の種類を上書きします。次のいずれかのオプションを選択します。
  • クラウドサービス展開: エージェントをCitrix CloudのWEMサービスに接続し、WEMの全機能を提供します。
  • オンプレミス展開: エージェントをオンプレミスのWEM展開に接続し、WEMの全機能を提供します。
  • 基本展開: WEMインフラストラクチャに接続せずに、制限された機能でエージェントをシングルマシンモードで実行します。
  • 無効: エージェントがインストールされているマシン上のすべてのWEM機能を無効にします。
CVADサービスからCitrix Cloud Connector™を検出。WEMのオンプレミスバージョンには適用されません。状態は「未構成」のままにします。
インフラストラクチャサーバー。WEMインフラストラクチャサーバーのアドレス。インフラストラクチャサービスがインストールされているマシンの名前またはIPアドレスを入力します。
エージェントサービスポート。エージェントがインフラストラクチャサーバーに接続するポート。エージェントサービスポートは、インフラストラクチャサービス構成中にエージェントサービスポートとして構成したポートと同じである必要があります。指定しない場合、ポートはデフォルトで8286になります。
キャッシュデータ同期ポート。（Workspace Environment Management 1912以降に適用。Workspace Environment Management 1909以前のキャッシュ同期ポートを置き換えます。）エージェントキャッシュ同期プロセスがインフラストラクチャサービスに接続して、エージェントキャッシュをインフラストラクチャサーバーと同期するポート。キャッシュデータ同期ポートは、インフラストラクチャサービス構成中にキャッシュデータ同期ポート（WEM Infrastructure Service Configuration > Network Settings）として構成したポートと同じである必要があります。ポートはデフォルトで8288であり、CachedDataSyncPortコマンドライン引数に対応します。または、WEMエージェントのサイレントインストールでコマンドラインオプションを使用してポートを指定することもできます。例：
  • citrix_wem_agent_bundle.exe /quiet CachedDataSyncPort=9000
Citrix Cloud™ Connectors。WEMのオンプレミスバージョンには適用されません。状態は未構成のままにします。
エージェントプロキシ構成。WEMのオンプレミスバージョンには適用されません。状態は未構成のままにします。
VUEMAppCmdの追加同期遅延。エージェントアプリケーションランチャー (VUEMAppCmd.exe) がCitrix Virtual Apps and Desktopsの公開リソースが起動するまでに待機する時間をミリ秒単位で指定します。これにより、必要なエージェント作業が最初に完了することが保証されます。推奨値は100から200です。デフォルト値は0です。

ステップ2：エージェントのインストール

重要:
.NET Frameworkはエージェントのインストール中に自動的にインストールできますが、エージェントをインストールする前に手動でインストールすることをお勧めします。そうしないと、エージェントのインストールを続行するためにマシンを再起動する必要があり、完了までに時間がかかる場合があります。
ユーザー環境でCitrix Workspace™ Environment Management Agentを実行できます。コマンドラインを使用してエージェントをインストールすることもできます。デフォルトでは、エージェントはオペレーティングシステムに応じて、次のいずれかのフォルダーにインストールされます。
  • C:\Program Files (x86)\Citrix\Workspace Environment Management Agent (64ビットOSの場合)
  • C:\Program Files\ Citrix\Workspace Environment Management Agent (32ビットOSの場合)
エージェントを対話形式でインストールするには、次の手順を実行します。
  1. マシンでCitrix Workspace Environment Management Agent.exeを実行します。
  2. ライセンス条項と条件に同意しますを選択し、インストールをクリックします。
  3. ようこそページで、次へをクリックします。
    注:
    ようこそページが表示されるまでに時間がかかる場合があります。この遅延は、必要なソフトウェアが不足しており、バックグラウンドでインストールされている場合に発生します。
  4. インストール先フォルダーページで、次へをクリックします。
    • デフォルトでは、インストール先フォルダーフィールドにはデフォルトのフォルダーパスが自動的に入力されます。エージェントを別のフォルダーにインストールする場合は、変更をクリックしてフォルダーに移動し、次へをクリックします。
    • WEMエージェントをすでにインストールしている場合、宛先フォルダーフィールドには既存のインストールフォルダーパスが自動的に入力されます。
  5. ページで、該当する展開の種類を選択し、 をクリックします。この場合は、 を選択します。
  6. 「基本展開」タイプを選択することもできます。「基本展開」タイプを選択すると、エージェントはインフラストラクチャサービスに接続せずに、デフォルトの最適化設定をオンにします。
    WEMエージェントのインストール 01
  7. ページで、エージェントが接続するインフラストラクチャサービスを指定し、 をクリックします。
    • 。グループポリシーを使用して設定をすでに構成している場合は、このオプションを選択します。
    • 。インフラストラクチャサービスのFQDNまたはIPアドレスを入力して、インフラストラクチャサービスを構成できます。
    • 。デフォルトでは、値は8286です。
    • 。デフォルトでは、値は8288です。
    WEMエージェントのインストール 02
  8. ページで、エージェントの詳細設定を構成し、 をクリックします。
    • 。エージェントキャッシュの代替場所を指定できます。 をクリックして、該当するフォルダーに移動します。または、レジストリを介して行うこともできます。これを行うには、まずCitrix WEM Agent Host Serviceを停止し、次のレジストリキーを変更します。
      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\エージェントホスト
      名前: AgentCacheAlternateLocation
      種類: REG_SZ
      値: 空
      既定では、値は空です。既定のフォルダーは次のとおりです: <WEM agent installation folder path>\Local Databases Set。必要に応じて、別のフォルダーパスを指定します。変更を有効にするには、Citrix WEM Agent Host Service を再起動します。変更が有効になると、LocalAgentCache.db および LocalAgentDatabase.db というファイルがフォルダーに表示されます。
      注意:
      レジストリを誤って編集すると、オペレーティングシステムの再インストールが必要になるような深刻な問題が発生する可能性があります。Citrixは、レジストリエディターの誤った使用によって生じる問題が解決されることを保証できません。レジストリエディターは自己責任で使用してください。編集する前に必ずレジストリをバックアップしてください。
    • VUEMAppCmd Extra Sync Delay (Optional)。エージェントアプリケーションランチャー (VUEMAppCmd.exe) が公開されたリソースを開始するまでに待機する時間を指定できます。この遅延を設定することで、必要なエージェント作業が最初に完了するようにします。既定値は 0 です。
      注:
      追加の同期遅延間隔に入力する値は、0 以上の整数である必要があります。
    WEM エージェントのインストール 03
  9. インストールの準備完了ページで、インストール をクリックします。
  10. 完了 をクリックしてインストールウィザードを終了します。
または、WEM エージェントのサイレントインストールを選択することもできます。そのためには、次のコマンドラインを使用します。
  • "Citrix Workspace Environment Management Agent.exe" /quiet Cloud=0
ヒント:
  • オンプレミス WEM 展開で実行されているエージェントの場合は、Cloud=0 を入力します。WEM サービス展開で実行されているエージェントの場合は、Cloud=1 を入力します。
  • エージェントのインストールに関するトラブルシューティングを行うには、ログファイルを参照することをお勧めします。既定では、インストール中に発生するすべてのアクションを記録するログファイルは %TEMP% に作成されます。/log log.txt コマンドを使用して、ログファイルを保存する特定の場所を指定できます。
コマンドラインオプションを使用してカスタム引数を指定することもできます。これにより、インストールプロセス中にエージェントとシステム設定をカスタマイズできます。詳細については、「知っておくと良いこと」を参照してください。
インストール後、エージェントは Citrix WEM Agent Host Service (旧 Norskale Agent Host Service) および Citrix WEM Agent User Logon Service として実行されます。エージェントはアカウント LocalSystem として実行されます。このアカウントの変更はサポートされていません。このサービスには、ローカルシステムとしてログオン のアクセス許可が必要です。

ステップ 3: インストールを完了するためにマシンを再起動します

前提条件と推奨事項

WEM エージェントが適切に機能するように、次の前提条件と推奨事項に注意してください。

前提条件

次の要件が満たされていることを確認します。
  • Windowsサービス「System Event Notification Service」は、起動時に自動的に開始するように構成されています。
  • WEMエージェントサービス「Citrix WEM Agent Host Service」と「Citrix WEM User Logon Service」は、起動時に自動的に開始するように構成されています。
  • エージェントキャッシュは、可能な限り永続的な場所に配置されます。非永続的なキャッシュの場所を使用すると、キャッシュ同期の問題、過剰なネットワークデータ使用量、パフォーマンスの問題などが発生する可能性があります。

おすすめ

エージェントの展開を成功させるには、このセクションの推奨事項に従ってください。
  • たとえば、ログオンスクリプトやスタートアップスクリプトを使用して、Citrix WEM Agent Host Serviceを手動で操作しないでください。Citrix WEM Agent Host Serviceの停止や再起動などの操作は、Netlogonサービスの動作を停止させ、他のアプリケーションで問題を引き起こす可能性があります。
  • UIモードまたはCMDモードのエージェントを起動するためにログオンスクリプトを使用しないでください。そうしないと、一部の機能が動作しなくなる可能性があります。

エージェントの起動動作

  • Citrix WEM Agent Host Serviceは、サービス開始後、グループポリシーを通じて構成されたCloud Connector設定を自動的に再ロードします。
  • Citrix WEM Agent User Logon Serviceは、最初のログオン時にエージェントホストサービスが起動しない場合、Citrix WEM Agent Host Serviceを自動的に起動します。この動作により、ユーザー構成が適切に処理されます。
  • Citrix WEM Agent Host Serviceは、起動時に次のローカルデータベースファイル（LocalAgentCache.dbおよびLocalAgentDatabase.db）のチェックを自動的に実行します。仮想マシンがプロビジョニングされており、ローカルデータベースファイルがベースイメージからのものである場合、データベースファイルは自動的にパージされます。
  • Citrix WEM Agent Host Serviceが起動すると、エージェントのローカルキャッシュが最近更新されたことを自動的に確認します。キャッシュが設定されたキャッシュ同期時間間隔の2倍以上更新されていない場合、キャッシュは直ちに同期されます。たとえば、デフォルトのエージェントキャッシュ同期間隔が30分であるとします。過去60分間にキャッシュが更新されていない場合、Citrix WEM Agent Host Serviceの起動直後に同期されます。
  • インストール中に、WEMエージェントインストーラーはWindowsサービス「System Event Notification Service」を自動的に開始するように構成します。
  • WEMエージェントのアップグレードが完了すると、WEMエージェントインストーラーはNetlogonサービスを自動的に開始します。

エージェントキャッシュユーティリティのオプション

Citrix WEM Agent Host Serviceは、設定の更新とキャッシュの同期を自動的に処理します。エージェントキャッシュユーティリティは、設定を直ちに更新し、キャッシュを同期する必要があるシナリオでのみ使用してください。
エージェントインストールフォルダーでコマンドラインを使用して AgentCacheUtility.exe を実行します。実行可能ファイルは、次のコマンドライン引数を受け入れます。
  • -help: 許可されている引数のリストを表示します。
  • -RefreshCache または -r: キャッシュの構築または更新をトリガーします。
  • -RefreshSettings または -S: エージェントホストの設定を更新します。
  • -Reinitialize または -I: -RefreshCache オプションと組み合わせて使用すると、エージェントキャッシュを再初期化します。
コマンドラインの使用方法の詳細については、次の例を参照してください。
  • エージェントホストの設定を更新します。
    • AgentCacheUtility.exe -RefreshSettings
  • エージェントホストの設定とエージェントキャッシュを同時に更新します。
    • AgentCacheUtility.exe -RefreshSettings -RefreshCache
  • エージェントキャッシュを再初期化します。
    • AgentCacheUtility.exe -RefreshCache -Reinitialize

知っておくと良いこと

エージェント実行可能ファイルは、「エージェント設定」および「システム設定」セクションで説明されているカスタム引数を受け入れます。

エージェント設定

WEMエージェント設定には以下が含まれます。
  • AgentLocation。エージェントのインストール場所を指定できます。有効なフォルダーパスを指定します。
  • AgentCacheLocation。エージェントキャッシュの代替場所を指定できます。構成されている場合、エージェントローカルキャッシュファイルは、エージェントインストールフォルダーではなく、指定された場所に保存されます。
  • AgentCacheSyncPort。エージェントキャッシュ同期プロセスがインフラストラクチャサービスに接続して、エージェントキャッシュをインフラストラクチャサーバーと同期するポートを指定できます。
  • AgentServicePort。エージェントがインフラストラクチャサーバーに接続するポートを指定できます。
  • InfrastructureServer。インフラストラクチャサービスが実行されているインフラストラクチャサーバーの FQDN または IP アドレスを指定できます。
  • VUEMAppCmdDelay。エージェントアプリケーションランチャー (VUEMAppCmd.exe) が Citrix Virtual Apps and Desktops の公開リソースが起動するまで待機する時間を指定できます。デフォルト値は 0 (ミリ秒) です。追加の同期遅延間隔として入力する値は、0 以上の整数である必要があります。
次の点に注意してください。
  • コマンドラインで設定を構成した場合、WEM エージェントインストーラーは構成された設定を使用します。
  • コマンドラインで設定を構成せず、以前に構成された設定がある場合、インストーラーは以前に構成された設定を使用します。
  • コマンドラインで設定を構成せず、以前に構成された設定がない場合、インストーラーはデフォルト設定を使用します。

システム設定

エージェントホストマシンに関連付けられているシステム設定には、次のものがあります。
  • GpNetworkStartTimeoutPolicyValue。インストール中に作成される GpNetworkStartTimeoutPolicyValue レジストリキーの値を秒単位で構成できます。この引数は、ログオン時のグループポリシー処理中にグループポリシーがネットワーク可用性通知を待機する時間を指定します。引数は 1 (最小) から 600 (最大) の範囲の任意の整数を受け入れます。デフォルトでは、この値は 120 です。
  • SyncForegroundPolicy。エージェントのインストール中に SyncForegroundPolicy レジストリ値を構成できます。このポリシー設定は、グループポリシー処理が同期であるかどうかを決定します。許容される値: 0、1。値が設定されていない場合、または値を 0 に設定した場合、Citrix WEM Agent User Logon Service はログオンを遅延させず、ユーザーグループポリシー設定はバックグラウンドで処理されます。値を 1 に設定した場合、Citrix WEM Agent User Logon Service はユーザーグループポリシー設定の処理が完了するまでログオンを遅延させます。デフォルトでは、インストール中に値は変更されません。
    重要:
    グループポリシー設定がバックグラウンドで処理される場合、すべてのポリシー設定が処理される前に Windows Shell (Windows エクスプローラー) が起動する可能性があります。そのため、一部の設定はユーザーが初めてログオンしたときに有効にならない場合があります。ユーザーが初めてログオンしたときにすべてのポリシー設定を処理したい場合は、値を 1 に設定します。
  • WaitForNetwork。インストール中に作成される WaitForNetwork レジストリキーの値を秒単位で構成できます。この引数は、エージェントホストがネットワークが完全に初期化され、利用可能になるまで待機する時間を指定します。引数は 0 (最小) から 300 (最大) の範囲の任意の整数を受け入れます。デフォルトでは、この値は 30 です。
前述の 3 つのキーは、Windows ログオン画面が表示される前に WEM エージェントサービスが開始されることを保証します。これら 3 つのキーはすべて、インストール中に HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon の下に作成されます。これらのキーはまた、ユーザー環境がログオン前にインフラストラクチャサーバーアドレス GPO を受信することを保証します。Active Directory またはドメインコントローラーサーバーの応答が遅いネットワーク環境では、ログオン画面が表示される前に追加の処理時間が発生する可能性があります。影響を与えるためには、GpNetworkStartTimeoutPolicyValue キーの値を最低 30 に設定することをお勧めします。
  • ServicesPipeTimeout。ServicesPipeTimeout レジストリキーの値を構成できます。このキーは、インストール中に HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control の下に作成されます。このレジストリキーは、サービスコントロールマネージャーが WEM エージェントサービスの状態を報告できるようになる前に遅延を追加します。この遅延により、ネットワークが初期化される前にエージェントサービスが起動するのを防ぎ、エージェントの障害を防止します。この引数は、ミリ秒単位の任意の値を指定できます。指定しない場合、デフォルト値の 60000 (60 秒) が使用されます。
    注:
    コマンドラインを使用して前述の設定を構成しない場合、WEM エージェントインストーラーはインストール中にそれらを処理しません。

例

次のコマンドライン形式を使用して設定を構成できます。
  • "Citrix Workspace Environment Management Agent.exe" <key=value>
例:
  • WEMエージェントのサイレントインストールまたはアップグレードを選択します
    • "Citrix Workspace Environment Management Agent.exe" /quiet Cloud=0
  • ユーザーログオンネットワーク待機時間を60秒に設定します
    • "Citrix Workspace Environment Management Agent.exe" WaitForNetwork=60