高度な設定

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

構成

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

メイン構成

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

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

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

エージェントオプション

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

詳細オプション

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

再接続アクション

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

高度な処理

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

サービスオプション

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

コンソール設定

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

StoreFront™

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

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設定をテストし、それらが正しいことを確認します。

省電力

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