詳細設定

最終公開日 : Nov 13, 2026
これらの設定は、エージェントがアクションを処理する方法とタイミングを変更します。

構成

これらのオプションは、基本的なエージェントの動作を制御します。

メイン構成

エージェントアクション。これらの設定は、エージェントがアクションタブで構成されたアクションを処理するかどうかを決定します。これらの設定は、ログオン時および更新時(自動または手動更新(ユーザーまたは管理者によってトリガーされる))に適用されます。
アプリケーションの処理。選択すると、エージェントはアプリケーションアクションを処理します。
プリンターの処理。選択すると、エージェントはプリンターアクションを処理します。
ネットワークドライブの処理。選択すると、エージェントはネットワークドライブアクションを処理します。
仮想ドライブの処理。選択すると、エージェントは仮想ドライブアクションを処理します。(仮想ドライブとは、ローカルファイルパスをドライブ文字にマッピングするWindows仮想ドライブまたはMS-DOSデバイス名です。)
レジストリ値の処理。選択すると、エージェントはレジストリエントリアクションを処理します。
環境変数の処理。選択すると、エージェントは環境変数アクションを処理します。
ポートの処理。選択すると、エージェントはポートアクションを処理します。
Iniファイル操作の処理。選択すると、エージェントは.iniファイルアクションを処理します。
外部タスクの処理。選択すると、エージェントは外部タスクアクションを処理します。
ファイルシステム操作の処理。選択すると、エージェントはファイルシステム操作アクションを処理します。
ファイル関連付けを処理します。選択すると、エージェントはファイル関連付けアクションを処理します。
ユーザーDSNを処理します。選択すると、エージェントはユーザーDSNアクションを処理します。
エージェントサービスアクション。これらの設定は、エージェントサービスがエンドポイントでどのように動作するかを制御します。
ログオン時にエージェントを起動します。エージェントがログオン時に実行されるかどうかを制御します。
再接続時にエージェントを起動します。ユーザーがエージェントが実行されているマシンに再接続したときに、エージェントが実行されるかどうかを制御します。
管理者向けにエージェントを起動します。ユーザーが管理者である場合にエージェントが実行されるかどうかを制御します。
エージェントの種類。ユーザーがエージェントと対話するときに、ユーザーインターフェイス (UI) またはコマンドラインプロンプト (CMD) のどちらが表示されるかを制御します。
(仮想) デスクトップ互換性を有効にします。エージェントが実行されているデスクトップとの互換性を確保します。この設定は、ユーザーがセッションにログオンしたときにエージェントが起動するために必要です。物理デスクトップまたはVDIデスクトップのユーザーがいる場合は、このオプションを選択します。
公開アプリケーションでCMDエージェントのみを実行します。有効にすると、公開アプリケーションではエージェントがUIモードではなくCMDモードで起動します。CMDモードでは、エージェントのスプラッシュ画面の代わりにコマンドプロンプトが表示されます。

クリーンアップアクション

このタブに表示されるオプションは、エージェントが更新されたときに、エージェントがショートカットやその他のアイテム(ネットワークドライブやプリンター)を削除するかどうかを制御します。ユーザーまたはユーザーグループにアクションを割り当てる場合、ショートカットやアイテムの作成も制御できることがわかります。これは、割り当て > アクションの割り当て > アクションの割り当てタブの割り当て済みペインでアクションのオプションを構成することで実行できます。Workspace Environment Management™ は、これらのオプションを特定の優先順位に従って処理します。
  1. クリーンアップアクションタブに表示されるオプション
  2. 割り当て済みペインで割り当てられたアクションに対して構成されたオプション
たとえば、割り当て済みペインで割り当てられたアプリケーションのデスクトップの作成オプションを有効にしており、アプリケーションのショートカットがすでにデスクトップに作成されているとします。クリーンアップアクションタブでデスクトップショートカットの削除オプションを有効にしていても、エージェントが更新されたときにショートカットはデスクトップに残ります。
起動時のショートカット削除。エージェントは、更新時に選択された種類のすべてのショートカットを削除します。
起動時にネットワークドライブを削除。有効にすると、エージェントは更新するたびにすべてのネットワークドライブを削除します。
起動時にネットワークプリンターを削除。有効にすると、エージェントは更新するたびにすべてのネットワークプリンターを削除します。
自動作成されたプリンターを保持。有効にすると、エージェントは自動作成されたプリンターを削除しません。
特定のプリンターを保持。有効にすると、エージェントはこのリスト内のプリンターを削除しません。

エージェントオプション

これらのオプションは、エージェントの設定を制御します。
エージェントログの有効化。エージェントログファイルを有効にします。
ログファイル。ログファイルの場所。デフォルトでは、これはログインユーザーのプロファイルルートです。
デバッグモード。これにより、エージェントの詳細ログが有効になります。
オフラインモードを有効にする。無効にすると、エージェントはインフラストラクチャサービスへの接続に失敗した場合でも、キャッシュにフォールバックしません。
オンライン時でもキャッシュを使用。有効にすると、エージェントは常にキャッシュから設定とアクションを読み取ります(キャッシュはエージェントサービスがサイクルするたびに構築されます)。
キャッシュを使用してアクション処理を高速化。有効にすると、エージェントはインフラストラクチャサービスからではなく、エージェントのローカルキャッシュから関連設定を取得してアクションを処理します。これにより、アクションの処理が高速化されます。デフォルトでは、このオプションは有効になっています。以前の動作に戻したい場合は、このオプションを無効にしてください。
重要:
  • エージェントのローカルキャッシュは、定期的にインフラストラクチャサービスと同期されます。そのため、アクション設定の変更が反映されるまでには、エージェントキャッシュの更新遅延オプション(詳細設定 > 構成 > サービスオプションタブ)で指定した値に応じて時間がかかります。
  • 遅延を減らすには、より低い値を指定します。変更をすぐに有効にするには、管理 > エージェント > 統計タブに移動し、該当するエージェントを右クリックして、コンテキストメニューからキャッシュの更新を選択します。
環境設定の更新。有効にすると、エージェントの更新が発生したときに、エージェントはユーザー環境設定の更新をトリガーします。環境設定の詳細については、「環境設定」を参照してください。
システム設定の更新。有効にすると、エージェントの更新時に、エージェントはWindowsシステム設定(Windowsエクスプローラーやコントロールパネルなど)の更新をトリガーします。
環境設定の変更時に更新。有効にすると、環境設定が変更されたときに、エージェントはエンドポイントでWindowsの更新をトリガーします。
デスクトップの更新。有効にすると、エージェントの更新時に、エージェントはデスクトップ設定の更新をトリガーします。デスクトップ設定の詳細については、「デスクトップ」を参照してください。
外観の更新。有効にすると、エージェントの更新時に、エージェントはWindowsテーマとデスクトップの壁紙の更新をトリガーします。
非同期プリンター処理。有効にすると、エージェントは他のアクションの処理完了を待たずに、プリンターを非同期で処理します。
非同期ネットワークドライブ処理。有効にすると、エージェントは他のアクションの処理完了を待たずに、ネットワークドライブを非同期で処理します。
初期環境クリーンアップ。有効にすると、エージェントは最初のログオン時にユーザー環境をクリーンアップします。具体的には、次の項目を削除します。
  • ユーザーネットワークプリンター。
    • クリーンアップアクションタブの自動作成されたプリンターを保持が有効になっている場合、エージェントは自動作成されたプリンターを削除しません。
    • クリーンアップアクションタブの特定のプリンターを保持が有効になっている場合、エージェントはリストで指定されたプリンターを削除しません。
  • ホームドライブであるネットワークドライブを除くすべてのネットワークドライブ。
  • すべての非システムデスクトップ、スタートメニュー、クイック起動、およびスタートボタンのコンテキストメニューのショートカット。
  • すべてのタスクバーとスタートメニューにピン留めされたショートカット。
初期デスクトップUIクリーンアップ。有効にすると、エージェントは最初のログオン時にセッションデスクトップをクリーンアップします。具体的には、次の項目を削除します。
  • すべての非システムデスクトップ、スタートメニュー、クイック起動、およびスタートボタンのコンテキストメニューのショートカット。
  • すべてのタスクバーとスタートメニューにピン留めされたショートカット。
アプリケーションの存在を確認する。有効にすると、エージェントは、ユーザーがサインインするマシンにアプリケーションが存在することを確認しない限り、ショートカットを作成しません。
アプリ変数を展開する。有効にすると、変数はデフォルトで展開されます(エージェントが変数を検出したときの通常の動作については、環境変数を参照してください)。
クロスドメインユーザーグループ検索を有効にする。有効にすると、エージェントはすべてのActive Directoryドメインでユーザーグループを照会します。注: これは非常に時間のかかるプロセスであり、必要な場合にのみ選択してください。
ブローカーサービスのタイムアウト。インフラストラクチャサービスへの接続に失敗した場合に、エージェントが独自のキャッシュに切り替えるまでのタイムアウト値。デフォルト値は15000ミリ秒です。
ディレクトリサービスのタイムアウト。エージェントホストマシン上のディレクトリサービスのタイムアウト値。この値を超えると、エージェントはユーザーグループ関連付けの独自の内部キャッシュを使用します。デフォルト値は15000ミリ秒です。
ネットワークリソースのタイムアウト。ネットワークリソース(ネットワークドライブまたはネットワーク上にあるファイル/フォルダーリソース)を解決するためのタイムアウト値。この値を超えると、エージェントはアクションが失敗したと見なします。デフォルト値は500ミリ秒です。
エージェントの最大並列度。エージェントが使用できるスレッドの最大数。デフォルト値は0(プロセッサが物理的に許容する最大数のスレッド)、1はシングルスレッド、2はデュアルスレッドなどです。通常、この値を変更する必要はありません。
通知を有効にする。有効にすると、インフラストラクチャサービスへの接続が失われたり復元されたりしたときに、エージェントはエージェントホストに通知メッセージを表示します。Citrix®は、品質の悪いネットワーク接続ではこのオプションを有効にしないことを推奨します。そうしないと、接続状態変更通知がエンドポイント(エージェントホスト)に頻繁に表示される可能性があります。

詳細オプション

エージェントアクションの実行を強制する。これらの設定が有効になっている場合、変更が行われていなくても、エージェントホストは常にそれらのアクションを更新します。
未割り当てのアクションを元に戻す。これらの設定が有効になっている場合、エージェントホストは次回更新時に未割り当てのアクションをすべて削除します。
自動更新。有効にすると、エージェントホストは自動的に更新されます。デフォルトでは、更新遅延は30分です。

再接続アクション

再接続時のアクション処理。これらの設定は、エージェントホストがユーザー環境に再接続したときに処理するアクションを制御します。

高度な処理

フィルター処理の強制実行。有効にすると、これらのオプションにより、エージェントホストは更新ごとにフィルターを再処理します。

サービスオプション

これらの設定は、エージェントホストサービスを構成します。
エージェントキャッシュ更新遅延。この設定は、Citrix WEMエージェントホストサービスがキャッシュを更新するまで待機する時間を制御します。更新により、キャッシュはWEMサービスデータベースと同期されます。デフォルトは30分です。
SQL設定更新遅延。この設定は、Citrix WEMエージェントホストサービスがSQL接続設定を更新するまで待機する時間を制御します。デフォルトは15分です。
エージェント追加起動遅延。この設定は、Citrix WEMエージェントホストサービスがエージェントホスト実行可能ファイルを起動するまで待機する時間を制御します。
ヒント:
エージェントホストにまず必要な作業を完了させたいシナリオでは、エージェントアプリケーションランチャー (VUEMAppCmd.exe) が待機する時間を指定できます。VUEMAppCmd.exe は、Citrix Virtual Apps and Desktops の公開アプリケーションが開始される前に、エージェントホストが環境の処理を完了するようにします。待機時間を指定するには、エージェントホスト構成グループポリシーで利用可能な VUEMAppCmd extra sync delay 設定を構成します。詳細については、「WEMエージェントのインストールと構成」を参照してください。
デバッグモードを有効にする。これにより、このサイトに接続するすべてのエージェントホストの詳細ログが有効になります。
ie4uinitチェックをバイパスする。デフォルトでは、Citrix WEMエージェントホストサービスは、エージェントホスト実行可能ファイルを起動する前にie4uinitが実行されるのを待機します。この設定により、エージェントホストサービスはie4uinitを待機しないようになります。
エージェント起動除外。有効にすると、指定されたユーザーグループに属するユーザーに対しては、Citrix WEMエージェントホストは起動されません。

コンソール設定

禁止ドライブ。このリストに追加されたドライブ文字は、ドライブリソースを割り当てる際のドライブ文字選択から除外されます。
割り当てプロセスでのドライブ文字の再利用を許可する。有効にすると、割り当てで使用されたドライブ文字は、他の割り当てでも引き続き使用できます。

StoreFront™

このタブを使用して、StoreFrontストアをWorkspace Environment Managementに追加します。その後、Actions > Applications > Application Listタブに移動して、それらのストアで利用可能なアプリケーションを追加できます。これにより、公開アプリケーションをエンドポイントへのアプリケーションショートカットとして割り当てることができます。詳細については、「アプリケーション」を参照してください。Transformer (キオスク) モードでは、割り当てられたStoreFrontアプリケーションアクションがApplicationsタブに表示されます。StoreFrontストアの詳細については、「StoreFrontのドキュメント」を参照してください。

ストアを追加するには

  1. 「追加」をクリックします。
  2. ストアの追加ダイアログに詳細を入力し、OKをクリックします。ストアは構成セットに保存されます。
ストアURL。Workspace Environment Management を使用してリソースにアクセスするストアのURL。URLは、http://hostname の形式で指定する必要があります。ここで、hostname はストアの完全修飾ドメイン名であり、port はプロトコルのデフォルトポートが利用できない場合にストアとの通信に使用されるポートです。
重要:
  • 使用するストアURLは、外部ネットワークから直接アクセスできる必要があり、Citrix ADCなどのソリューションの背後にあってはなりません。
  • この機能は、多要素認証を使用するStoreFrontでは動作しません。
説明。ストアを説明するオプションのテキスト。

ストアを編集するには

リストからストアを選択し、編集をクリックしてストアのURLまたは説明を変更します。

ストアを削除するには

リストからストアを選択し、削除をクリックして構成セットからストアを削除します。

変更を適用するには

適用をクリックして、ストア設定をエージェントにすぐに適用します。

エージェントの切り替え

このタブにあるオプションを使用すると、オンプレミスエージェントからサービスエージェントに切り替えることができます。
重要:
エージェントの切り替えは、構成セットレベルで機能します。実行する切り替え操作は、構成セット内のエージェントのみに影響します。
サービスエージェントに切り替える。有効にすると、エージェントはオンプレミスエージェントからサービスエージェントに切り替わります。その後、エージェントが接続するCitrix Cloud™ Connectorを指定できます。これは、既存のオンプレミス展開をWEMサービスに移行する場合に役立ちます。
警告:
このオプションは、オンプレミス展開をWEMサービスに移行する場合にのみ有効にしてください。この移行は、WEM管理コンソールから元に戻すことはできません。
Citrix Cloud Connectorを構成する。Cloud ConnectorのFQDNまたはIPアドレスを入力して、Citrix Cloud Connectorを構成できます。追加をクリックして、一度に1つのCloud Connectorを追加します。高いサービス可用性を確保するために、Citrixは各リソースの場所に少なくとも2つのCloud Connectorをインストールすることを推奨しています。したがって、少なくとも2つのCitrix Cloud Connectorを構成する必要があります。
Citrix Cloud Connector™の構成をスキップする。グループポリシーを使用してCitrix Cloud Connectorを構成する場合は、このオプションを選択します。
重要:
詳細設定 > 構成 > サービスオプションタブで構成したSQL設定の更新遅延設定によっては、エージェント切り替え設定が有効になるまでに時間がかかる場合があります。
オンプレミスエージェントからサービスエージェントに切り替えた後、エージェントがWEMサービスに接続できない場合があり、ロールバックが必要になることがあります。その場合は、AgentConfigurationUtility.exeコマンドラインを使用します。例:
  • <WEM agent installation folder path>AgentConfigurationUtility.exe switch -o --server <server name> --agentport <port number> --syncport <port number>
  • <WEM agent installation folder path>AgentConfigurationUtility.exe switch -o --server <server name>
  • <WEM agent installation folder path>AgentConfigurationUtility.exe switch --usegpo -o

Wake on LAN (ウェイク・オン・ラン)

このタブを使用して、エージェントホストをリモートで起動します。WEMは、ターゲットエージェントと同じサブネットにあるエージェントを自動的に選択し、それらのエージェントをWake on LANメッセンジャーとして使用します。この機能には、Wake on LANと互換性のあるハードウェアが必要です。この機能を使用するには、ターゲットマシンがハードウェア要件を満たし、関連するBIOS設定が構成されていることを確認してください。
エージェントのWake on LANを有効にする。エージェントホストのWake on LANを有効にするために、Windowsオペレーティングシステムの設定を構成するかどうかを制御します。選択した場合、エージェントは次のシステム設定を構成します。
  • ネットワークアダプターのEnergy Efficient Ethernetを無効にする
  • ネットワークアダプターのWake on Magic Packetを有効にする
  • ネットワークアダプターのこのデバイスでコンピューターのスタンバイ状態を解除できるようにするを有効にする
  • ネットワークアダプターのMagic Packetでのみコンピューターのスタンバイ状態を解除できるようにするを有効にする
  • 高速スタートアップを有効にするを無効にする
このオプションを有効にした後、管理 > エージェント > 統計タブに移動し、リストから1つ以上のエージェントを選択して、エージェントの起動をクリックして選択したエージェントを起動します。

UIエージェントのパーソナライズ

これらのオプションを使用すると、UIモードのエージェントの外観をパーソナライズできます。これらのオプションは、UIエージェントがユーザー環境でどのように表示されるかを決定します。
注:
これらのオプションは、UIモードのエージェントにのみ適用されます。CMDモードのエージェントには適用されません。

UIエージェントオプション

これらの設定により、ユーザー環境におけるセッションエージェント(UIモードのみ)の外観をカスタマイズできます。
カスタム背景画像パス。指定した場合、エージェントの起動時または更新時に、Citrix Workspace Environment Managementロゴの代わりにカスタムスプラッシュスクリーンが表示されます。画像はユーザー環境からアクセスできる必要があります。400*200 pxの.bmpファイルを使用することをお勧めします。
読み込み円の色。カスタム背景に合わせて読み込み円の色を変更できます。
テキストラベルの色。カスタム背景に合わせて読み込みテキストの色を変更できます。
UIエージェントスキン。UIエージェントから開くダイアログに使用する事前構成済みのスキンを選択できます。たとえば、アプリケーションの管理ダイアログやプリンターの管理ダイアログなどです。注: この設定はスプラッシュスクリーンを変更しません。
エージェントスプラッシュスクリーンを非表示。有効にすると、エージェントの読み込み時または更新時にスプラッシュスクリーンが非表示になります。この設定は、エージェントが最初に更新されるときには適用されません。
公開アプリケーションでエージェントアイコンを非表示。有効にすると、公開アプリケーションにエージェントアイコンが表示されません。
公開アプリケーションでエージェントスプラッシュスクリーンを非表示。有効にすると、エージェントが実行されている公開アプリケーションのエージェントスプラッシュスクリーンが非表示になります。
管理者のみエージェントを終了可能。有効にすると、管理者のみがエージェントを終了できます。その結果、管理者以外のユーザーのエンドポイントでは、エージェントメニューの終了オプションが無効になります。
ユーザーによるプリンターの管理を許可。有効にすると、エージェントメニューのプリンターの管理オプションがエンドポイントのユーザーに利用可能になります。ユーザーはこのオプションをクリックしてプリンターの管理ダイアログを開き、デフォルトプリンターを設定したり、印刷設定を変更したりできます。デフォルトでは、このオプションは有効になっています。
ユーザーによるアプリケーションの管理を許可。有効にすると、エージェントメニューのアプリケーションの管理オプションがエンドポイントのユーザーに利用可能になります。ユーザーはこのオプションをクリックしてアプリケーションの管理ダイアログを開き、以下のオプションを設定できます。デフォルトでは、このオプションは有効になっています。
  • デスクトップ。アプリケーションのショートカットをデスクトップに追加します。
  • スタートメニュー。スタートメニューフォルダにアプリケーションのショートカットを作成します。
  • クイック起動。アプリケーションをクイック起動ツールバーに追加します。
  • タスクバー (P)。タスクバーにアプリケーションのショートカットを作成します。
  • スタートメニュー (P)。アプリケーションをスタートメニューにピン留めします。
    注:
    自己修復モードで作成されたショートカットは、このメニューを使用して削除できません。 クイック起動オプションは、Windows XPおよびWindows Vistaでのみ利用可能です。
管理者がエージェントを終了できないようにする。有効にすると、管理者はエージェントを終了できません。
アプリケーションショートカットを有効にする。有効にすると、エージェントメニューに「マイアプリケーション」オプションを表示するかどうかを制御します。ユーザーは「マイアプリケーション」メニューからアプリケーションを実行できます。デフォルトでは、このオプションは有効になっています。
管理リフレッシュのフィードバックを無効にする。有効にすると、管理者が管理コンソールを通じてエージェントのリフレッシュを強制した場合でも、このオプションはユーザー環境に通知を表示しません。
ユーザーによるアクションのリセットを許可する。エージェントメニューに「アクションのリセット」オプションを表示するかどうかを制御します。デフォルトでは、このオプションは無効になっています。「アクションのリセット」オプションを使用すると、現在のユーザーは自分の環境でリセットするアクションを指定できます。ユーザーが「アクションのリセット」を選択すると、「アクションのリセット」ダイアログが表示されます。このダイアログでは、ユーザーはリセットする内容を細かく制御できます。ユーザーは該当するアクションを選択し、「リセット」をクリックできます。これにより、対応するアクション関連のレジストリエントリが削除されます。
注:
  • エージェントメニューでは、次の2つのオプションが常に利用可能です。「更新」と「バージョン情報」。「更新」オプションは、WEMエージェント設定の即時更新をトリガーします。その結果、管理コンソールで構成された設定はすぐに有効になります。「バージョン情報」オプションは、使用中のエージェントに関するバージョン詳細を表示するダイアログを開きます。

ヘルプデスクオプション

これらのオプションは、エンドポイントのユーザーが利用できるヘルプデスク機能を制御します。
ヘルプリンクアクション。エンドポイントのユーザーが「ヘルプ」オプションを利用できるかどうか、およびユーザーがそれをクリックしたときに何が起こるかを制御します。ユーザーがヘルプを求めることができるウェブサイトのリンクを入力します。
カスタムリンクアクション。エージェントメニューに「サポート」オプションを表示するかどうか、およびユーザーがそれをクリックしたときに何が起こるかを制御します。ユーザーがサポート関連情報にアクセスできるウェブサイトのリンクを入力します。
画面キャプチャを有効にする。エージェントメニューに「キャプチャ」オプションを表示するかどうかを制御します。ユーザーはこのオプションを使用して画面キャプチャツールを開くことができます。このツールには次のオプションがあります。
  • 新規キャプチャ。ユーザー環境のエラーのスクリーンショットを撮ります。
  • 保存。スクリーンショットを保存します。
  • サポートに送信。スクリーンショットをサポート担当者に送信します。
サポートへの送信オプションを有効にする。スクリーンショットツールでサポートに送信オプションを表示するかどうかを制御します。有効にすると、ユーザーは指定された形式で、スクリーンショットとログファイルを指定されたサポートメールアドレスに直接送信できます。この設定には、動作する設定済みのメールクライアントが必要です。
カスタム件名。有効にすると、スクリーンショットツールがサポートメールを送信する際に使用するメール件名テンプレートを指定できます。
メールテンプレート。スクリーンショットツールがサポートメールを送信する際に使用するメールコンテンツテンプレートを指定できます。このフィールドは空にできません。
注:
メールテンプレートで使用できるハッシュタグのリストについては、動的トークンを参照してください。 ##UserScreenCaptureComment## ハッシュタグがメールテンプレートに含まれている場合にのみ、ユーザーにコメントを入力するオプションが表示されます。
SMTPを使用してメールを送信。有効にすると、MAPIではなくSMTPを使用してサポートメールを送信します。
SMTPのテスト。上記で入力したSMTP設定をテストし、それらが正しいことを確認します。

省電力

指定した時刻にシャットダウン。有効にすると、エージェントは実行中のマシンを指定された時刻に自動的にシャットダウンします。時刻はエージェントのタイムゾーンに基づきます。
アイドル時にシャットダウン。有効にすると、マシンが指定された時間アイドル状態(ユーザー入力なし)になった後、エージェントは実行中のマシンを自動的にシャットダウンします。