エージェントのインストール

最終公開日 : Nov 13, 2026
この記事では、Workspace Environment Management™ (WEM) エージェントについて説明します。記事の残りの部分では、エージェントインストールウィザードの手順について説明します。エージェントに関する追加情報も提供されています。
Related information
開始する: 展開を計画して構築する

はじめに

WEM が管理する各マシンには、WEM エージェントがインストールされている必要があります。WEM エージェントは WEM サービスに接続し、管理コンソールで構成した設定を適用します。すべての通信は、Citrix Cloud™ Messaging Service を使用して HTTPS 経由で行われます。すべてのエージェントはローカルキャッシュを使用するため、ネットワーク接続が中断されても既存の設定を引き続き使用できます。
WEM は、ドメイン参加済みマシンと非ドメイン参加済みマシンの両方の管理をサポートしています。
  • ドメイン参加済みマシンの場合、エージェントホストマシンが、構成済みの Cloud Connector と同じ Active Directory ドメインに属していることを確認してください。また、各リソースの場所にあるエージェントホストマシンが正しく参加していることを確認してください。
  • 非ドメイン参加済みマシンにエージェントをインストールするプロセスは、ドメイン参加済みマシンにインストールするプロセスと似ています。ただし、すべての要件を満たし、プロセス全体で正しいオプションを選択していることを確認してください。詳しくは、「非ドメイン参加済みマシンの管理」を参照してください。
エージェントを WEM サービスに接続する方法は 3 つあります。
  • クラウドコネクタ
  • ドメイン非参加
  • 登録
これらの方法について詳しくは、「使用するセットアップ方法の決定」を参照してください。

エージェントのインストール

注:
管理コンソールからアプリケーションショートカットとして Citrix Workspace で公開されているリソースにアクセスするには、Citrix Workspace app for Windows がエージェントマシンにインストールされていることを確認してください。詳しくは、「システム要件」を参照してください。
WEM エージェントをインストールするには、次の手順に従います。

手順 1：エージェントのダウンロード

WEM サービス Utilities タブから WEM エージェントパッケージ (Citrix-Workspace-Environment-Management-Agent-Setup.zip) をダウンロードし、各エージェントホストにコピーを保存します。

手順 2：グループポリシーの構成（オプション）

重要:
非ドメイン参加または登録方法を使用する場合は、この手順をスキップしてください。
オプションで、グループポリシーを構成できます。WEMエージェントパッケージで提供されるAgent Group Policies管理用テンプレートは、Agent Host Configurationポリシーを追加します。
  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. グループポリシー管理エディターウィンドウで、Computer Configuration > Policies > Administrative Templates > Citrix Components > Workspace Environment Management > Agent Host Configurationに移動し、次の設定を構成します。
    グループポリシー管理エディター Custom settings for basic deployment。展開に使用されるカスタマイズされたエージェント設定。基本的な展開で利用可能なエージェント設定の詳細については、「Manage Basic Deployment-agents」を参照してください。
    基本的な展開のカスタム設定
Override Agent Deployment Type。WEMエージェントの展開タイプを上書きします。次のいずれかのオプションを選択します。
  • Cloud service deployment: エージェントをCitrix CloudのWEMサービスに接続し、WEMの全機能を提供します。
  • オンプレミス展開: エージェントをオンプレミスのWEM展開に接続し、完全なWEM機能を提供します。
  • 基本展開: エージェントを単一マシンモードで実行し、機能が制限され、WEMインフラストラクチャに接続しません。
  • 無効: エージェントがインストールされているマシン上のすべてのWEM機能を無効にします。
エージェントプロキシ構成。WEMエージェントは、Citrix CloudのWEMサービスに接続するためにインターネット接続に依存します。エージェントとサービス間の通信は、以下の目的を果たします。
  • 統計とステータスをWEMサービスにアップロードする
  • エージェントキャッシュをWEMサービスデータベースと同期させる
  • エージェント設定と、エージェントの構成セットに固有のWEM設定を取得する
オプションで、HTTPSプロキシを構成して、エージェントがサービスと通信する方法を定義できます。そのためには、エージェントプロキシ構成ポリシーをダブルクリックし、この形式でプロキシサーバーアドレスを入力します: http://<FQDN or IP address>:<port number>。例: http://10.108.125.51:8080。
注:
WEMサービスは、認証を必要とするプロキシサーバーをサポートしていません。
エージェントサービスポート。WEMサービスには不要です。状態を「未構成」のままにします。
キャッシュデータ同期ポート。WEMサービスには不要です。状態を「未構成」のままにします。
Citrix Cloud Connectors。少なくとも1つのCitrix Cloud Connectorを構成します。エージェントホストマシンは、構成されたCloud Connectorマシンと同じADドメインにある必要があります。
CVADサービスからCitrix Cloud Connectorを検出する。エージェント用にCloud Connectorをまだ構成していない場合に、エージェントが関連するCitrix DaaS（旧Citrix Virtual Apps and Desktops™サービス）展開からCloud Connector情報を検出するかどうかを制御できます。その後、エージェントは対応するCloud Connectorマシンに接続します。
注:
  • この設定は、WEMエージェントがCitrix DaaS™展開で実行されているシナリオ向けに設計されています。
  • エージェントのインストール中にCloud Connectorが構成されている場合、またはCitrix Cloud Connectorsポリシー設定が有効になっている場合、このポリシー設定は機能しません。
インフラストラクチャサーバー。WEMサービスには不要です。状態は「未構成」のままにします。
VUEMAppCmd の追加同期遅延。公開されたリソースが起動される前に、エージェントアプリケーションランチャー (VUEMAppCmd.exe) が待機する時間をミリ秒単位で指定します。これにより、必要なエージェント作業が最初に完了することが保証されます。推奨値は100～200です。デフォルト値は0です。

ステップ3：エージェントをインストールする

重要:
.NET Framework はエージェントのインストール中に自動的にインストールできますが、エージェントをインストールする前に手動でインストールすることをお勧めします。そうしないと、エージェントのインストールを続行するためにマシンを再起動する必要があり、完了までに時間がかかる場合があります。
エージェントセットアッププログラム Citrix Workspace™ Environment Management Agent は、エージェントのダウンロードに含まれています。エージェントは、対話形式またはコマンドラインを使用してインストールできます。デフォルトでは、エージェントはオペレーティングシステム (OS) に応じて、次のいずれかのフォルダーにインストールされます。
  • 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. 「展開の種類」ページで、該当する展開の種類を選択し、「次へ」をクリックします。この場合は、「Cloud Service Deployment」を選択します。
  6. 「Basic Deployment」タイプを選択することもできます。「Basic Deployment」タイプを選択すると、エージェントはインフラストラクチャサービスに接続せずに、デフォルトの最適化設定をオンにします。「Basic deployment」タイプは、新規インストールの場合のデフォルトの展開タイプです。
    基本展開
  7. 「Cloud Service Configuration」ページで、エージェントが接続するCitrix Cloud Connectorを指定し、「次へ」をクリックします。
    • 「構成をスキップ」。次の場合にこのオプションを選択します。
      • グループポリシーを使用して設定をすでに構成している場合。
      • エージェントマシンがドメインに参加していないマシンである場合。「ドメインに参加していないマシンの管理」を参照してください。
      • Cloud Connectorを構成せずにエージェントを登録する場合。「エージェントの登録」を参照してください。
    • 「Citrix Cloud Connectorの構成」。エージェントが接続するCitrix Cloud Connectorを、Cloud ConnectorのFQDNまたはIPアドレスをコンマ区切りリストで入力して構成します。
      注:
      • 各Citrix Cloud ConnectorのFQDNまたはIPアドレスを入力します。FQDNまたはIPアドレスをコンマ (,) で区切ってください。
      • 複数のCloud Connectorが構成されているシナリオでは、WEMエージェントはリストから到達可能なCloud Connectorをランダムに選択します。この設計は、すべてのCloud Connectorにトラフィックを分散することを目的としています。
    WEMエージェントのインストール 02
  8. 「Advanced Settings」ページで、エージェントの詳細設定を構成し、「次へ」をクリックします。
    • 「代替キャッシュの場所 (オプション)」。エージェントキャッシュの代替場所を指定できます。「参照」をクリックして、該当するフォルダーに移動します。または、レジストリを介して行うこともできます。そのためには、まず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 追加同期遅延 (オプション)。エージェントアプリケーションランチャー (VUEMAppCmd.exe) が公開されたリソースを開始する前に待機する時間を指定できます。これにより、必要なエージェント作業が最初に完了することが保証されます。デフォルト値は 0 です。
      注:
      追加同期遅延間隔に入力する値は、0 以上の整数である必要があります。
    WEM エージェントのインストール 03
  9. ページで、 をクリックします。
  10. をクリックして、インストールウィザードを終了します。
または、コマンドラインを使用して WEM エージェントのサイレントインストールを選択することもできます。これを行うには、次のコマンドラインを使用します。
  • Citrix Workspace Environment Management Agent.exe /quiet Cloud=1
ヒント:
  • WEM サービス展開で実行されているエージェントの場合は、Cloud=1 を入力します。オンプレミス WEM 展開で実行されているエージェントの場合は、Cloud=0 を入力します。
  • エージェントのインストールをトラブルシューティングするために、ログファイルを参照することをお勧めします。デフォルトでは、インストール中に発生するすべてのアクションを記録するログファイルは %TEMP% に作成されます。/log log.txt コマンドを使用して、ログファイルを保存する特定の場所を指定できます。
コマンドラインオプションを使用してカスタム引数を指定することもできます。これにより、インストールプロセス中にエージェントとシステムの設定をカスタマイズできます。詳細については、「知っておくと良いこと」を参照してください。
インストール後、エージェントは次のサービスとして実行されます: Citrix WEM Agent Host Service および Citrix WEM Agent User Logon Service。エージェントは LocalSystem として実行されます。このアカウントの変更はサポートされていません。エージェントサービスには、「ローカルシステムとしてログオン」権限が必要です。

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

エージェントのアンインストール

  1. エージェントがインストールされているマシンで、システムのコントロールパネルを開きます。
  2. プログラムと機能をクリックします。
  3. Citrix Workspace Environment Management Agentを選択し、メニューのアンインストールをクリックします。
VDAのインストール時にエージェントを追加コンポーネントとしてインストールした場合は、VDAインストーラーで利用可能なWEMインストーラー（MSI）を使用してエージェントをアンインストールします。WEMインストーラーcitrix_wem_agent_core.msiは<VDA installer path>\x64\Virtual Desktop Componentsにあります。VDAの追加コンポーネントとしてインストールされたエージェントをアンインストールするには、次の手順を実行します。
  1. フォルダー内で、citrix_wem_agent_core.msiを右クリックします。
  2. アンインストールを選択します。
注:
エージェントをアンインストールした後、VDAインストーラーまたはWEMインストーラーを使用してインストールできます。Citrix Virtual Apps and Desktops 2209以降、WEMエージェントはVDAインストールに追加コンポーネントとして含まれなくなりました。インストールするには、Citrix Virtual Apps and Desktops製品ISOにあるフルプロダクトインストーラーを使用します。詳しくは、「コアコンポーネントのインストール」を参照してください。

次のステップ

既存のオンプレミスWEMデータベースをWEMサービスに移行する場合は、「クラウドへの移行」を参照してください。
WEMサービスをすぐに開始するには、管理コンソールを起動し、必要に応じて設定を構成します。利用可能なコンソールは2つあります。
レガシーコンソールからWebコンソールへの機能移行を進めています。Webコンソールはレガシーコンソールよりも応答が速く、より多くの機能を提供します。Webコンソールでのみ利用可能な機能については、「新機能」を参照してください。

前提条件と推奨事項

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

前提条件

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

おすすめ

エージェントの展開を成功させるには、このセクションの推奨事項に従ってください。
  • ログオンスクリプトやスタートアップスクリプトを使用して、Citrix WEM Agent Host Serviceを手動で操作しないでください。Citrix WEM Agent Host Serviceの停止や再起動などの操作は、Net Logonサービスが機能しなくなる原因となり、他のアプリケーションに問題を引き起こす可能性があります。
  • 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エージェントインストーラーはNet Logonサービスを自動的に開始します。

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

Citrix WEM Agent Host Service は、設定の更新とキャッシュの同期を自動的に処理します。設定を即座に更新し、キャッシュを同期する必要がある場合にのみ、エージェントキャッシュユーティリティを使用してください。
コマンドラインを使用して、エージェントインストールフォルダーで AgentCacheUtility.exe を実行します。実行可能ファイルは、次のコマンドライン引数を受け入れます。
  • -help: 許可されている引数の一覧を表示します。
  • -RefreshCache または -r: キャッシュの構築または更新をトリガーしますが、これは現在廃止されており、エージェントバージョン 2401.1.0.1 より前のバージョンでのみ利用可能です。
  • -RefreshSettings または -S: エージェントバージョン 2401.1.0.1 以降のエージェントキャッシュを含むエージェントホスト設定を更新します。
  • -Reinitialize または -I: エージェント上のエージェントキャッシュを再初期化します。これにより、エージェントは遅延なくWEMデータベースから直接最新の設定を取得するために、即座にエージェントキャッシュの同期を要求します。
コマンドラインの使用方法の詳細については、以下の例を参照してください。
  • エージェントホスト設定を更新する:
    • AgentCacheUtility.exe -RefreshSettings
  • エージェントホスト設定とエージェントキャッシュを同時に更新する:
    • AgentCacheUtility.exe -RefreshSettings -RefreshCache
  • エージェントキャッシュを再初期化する:
    • AgentCacheUtility.exe -RefreshCache -Reinitialize

知っておくと良いこと

エージェント実行可能ファイルは、以下に説明するカスタム引数を受け入れます。

エージェント設定

WEMエージェント設定については、以下を参照してください。
  • AgentLocation。エージェントのインストール場所を指定できます。有効なフォルダーパスを指定してください。
  • CloudConnectorList。各Citrix Cloud ConnectorのFQDNまたはIPアドレスを指定できます。FQDNまたはIPアドレスはコンマ (,) で区切ってください。
    Cloud Connector リスト
  • VUEMAppCmdDelay。エージェントアプリケーションランチャー (VUEMAppCmd.exe) がCitrix Virtual Apps and Desktopsの公開リソースが起動するまで待機する時間を指定できます。デフォルト値は0 (ミリ秒) です。追加の同期遅延間隔に入力する値は、0以上の整数である必要があります。
  • AgentCacheLocation。エージェントキャッシュの代替場所を指定できます。設定されている場合、エージェントのローカルキャッシュファイルは、エージェントのインストールフォルダではなく、指定された場所に保存されます。
次の点を考慮してください。
  • 設定がコマンドラインを介して構成されている場合、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 Explorer) が起動する可能性があります。そのため、ユーザーが初めてログオンしたときに一部の設定が有効にならない場合があります。ユーザーが初めてログオンしたときにすべてのポリシー設定を処理したい場合は、値を1に設定します。
  • WaitForNetwork。インストール中に作成されるWaitForNetworkレジストリキーの値を秒単位で構成できます。この引数は、エージェントホストがネットワークが完全に初期化され、利用可能になるまで待機する時間を指定します。この引数は、0 (最小) から300 (最大) の範囲の任意の整数を受け入れます。デフォルトでは、この値は30です。
上記の3つのキーはすべて、インストール中にHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogonの下に作成されます。これらのキーは、ユーザー環境がログオン前にインフラストラクチャサーバーアドレスGPOを受信することを保証するために機能します。Active Directoryまたはドメインコントローラーサーバーの応答が遅いネットワーク環境では、ログオン画面が表示されるまでに余分な処理時間が発生する可能性があります。Citrixは、影響を与えるためにGpNetworkStartTimeoutPolicyValueキーの値を最低30に設定することを推奨します。
  • ServicesPipeTimeout。ServicesPipeTimeoutレジストリキーの値を構成できます。このキーは、インストール中にHKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Controlの下に作成されます。このレジストリキーは、サービスコントロールマネージャーがWEMエージェントサービスの状態を報告できるようになる前に遅延を追加します。この遅延により、ネットワークが初期化される前にエージェントサービスが起動するのを防ぎ、エージェントの障害を防止します。この引数は、ミリ秒単位の任意の値を受け入れます。指定されていない場合、デフォルト値の60000 (60秒) が使用されます。
    注:
    前述の設定がコマンドラインを使用して構成されていない場合、インストール中にWEMエージェントインストーラーによって処理されません。

例

次のコマンドライン形式を使用して設定を構成することもできます。
  • "Citrix Workspace Environment Management Agent.exe" <key=value>
例:
  • エージェントのインストール場所とシトリックス クラウド コネクタを指定します
    • "Citrix Workspace Environment Management Agent.exe" /quiet AgentLocation="L:\WEM Agent" Cloud=1 CloudConnectorList=cc1.qa.local,cc2.qa.local
  • ユーザーログオンネットワーク待機時間を60秒に設定します
    • "Citrix Workspace Environment Management Agent.exe" WaitForNetwork=60