基本展開エージェントの管理

最終公開日 : Nov 13, 2026
Workspace Environment Management™ (WEM) を使用して、基本展開エージェントを管理できます。この機能は、WEM を展開するための軽量な方法を提供します。この展開方法を使用すると、ブローカー、データベース、コンソールなどのバックエンドコンポーネントを展開することなく、WEM の基本機能を簡単に利用できます。

基本展開エージェント設定の構成

WEM エージェントが基本モードの場合、一部の最適化機能はデフォルトで有効になります。これらの設定は、事前定義されたエージェントキャッシュファイルに保存されます。
  • VDA マシンでの CPU スパイク保護は自動的にオンになります。この設定は、CPU 使用率の高いプロセスの優先度を下げて、ユーザーエクスペリエンスへの影響を最小限に抑えます。
    • CPU スパイク保護
    • CPU スパイクを自動的に防止する
    • インテリジェントな CPU 最適化を有効にする
  • 基本展開エージェントの設定をカスタマイズします。詳細については、「グループポリシーの構成」を参照してください。基本モードで利用可能な設定は次のとおりです。
プロパティ 種類 設定 デフォルト 例 注
enableCpuSpikeProtection ブール値 CPU スパイク保護を有効にする 真 真 CPU スパイク保護設定
enableCpuAutoProtection ブール値 CPUスパイクを自動的に防止する 真 真
cpuUsageLimitOfSpikeProtection 浮動小数点数 CPU使用率の制限 (%) 70.0 70.0
enablePerCoreCpuUsageLimit ブール値 単一CPUコアに対する制限を設定する 偽 偽
perCoreCpuUsageLimitOfSpikeProtection 浮動小数点数 単一CPUコアに対するCPU使用率の制限 (%) 80.0 80.0
cpuUsageLimitSampleTimeOfSpikeProtection 整数 サンプル時間制限 (秒) 30 30
idlePriorityTimeOfSpikeProtection 整数 アイドル優先時間 (秒) 180 180
enableLimitCpuCoreUsage ブール値 CPUコア使用制限を有効にする 偽 偽
cpuCoreLimitOfSpikeProtection 整数 CPUコア使用制限 1 1
enableIntelligentCpuOptimization ブール値 インテリジェントCPU最適化を有効にする 真 真
enableIntelligentIoOptimization ブール値 インテリジェントI/O最適化を有効にする 偽 偽
excludeProcessesFromCpuSpikeProtection ブール値 CPUスパイク保護からプロセスを除外する 偽 偽
processesExcludedFromCpuSpikeProtection 文字列の配列 プロセス名 [] ["devenv", "msbuild"]
disableProcessPriorityInheritance ブール値 子プロセスがCPU優先度を継承するのを防ぐ 偽 偽
parentProcessesToDisablePriorityInheritance 文字列の配列 プロセス名 [] ["devenv", "msbuild"]
enableMemoryWorkingSetOptimization ブール値 アイドルプロセスでのメモリ使用量を最適化する 真 真 メモリ最適化設定
idleSampleTimeOfMemoryWorkingSetOptimization 整数 アイドルサンプル時間 (分) 30 30
idleStateLimitOfMemoryWorkingSetOptimization 整数 アイドル状態の制限 (%) 1 1
enableMemoryOptimizationThreshold ブール値 最適化を制限する 真 真
memoryOptimizationThreshold 整数 合計利用可能メモリが (MB) 未満の場合にのみ最適化する 200 200
excludeProcessesFromMemoryWorkingSetOptimization ブール値 メモリ使用量の最適化からプロセスを除外する いいえ いいえ
processesExcludedFromMemoryWorkingSetOptimization 文字列の配列 プロセス名 [] ["devenv", "msbuild"]
enableFastLogoff ブール値 高速ログオフを有効にする 真 真 高速ログオフ設定
enableMultiSessionOptimization ブール値 マルチセッション最適化を有効にする 真 真 マルチセッション最適化
excludeProcessesFromMultiSessionOptimization ブール値 マルチセッション最適化からプロセスを除外する いいえ いいえ
processesExcludedFromMultiSessionOptimization 文字列の配列 プロセス名 [] ["devenv", "msbuild"]
agentServiceDebugModeEnabled ブール値 エージェントサービスデバッグモードを有効にする 偽 偽 詳細設定 > エージェント設定 > エージェントサービスオプション
enableLogonDurationAnalysis ブール値 ログオン期間分析を有効にする 真 真 ログオン期間分析
useAlternativeLocalReportLocation ブール値 ローカルエージェントレポートを保存するための代替場所を使用する 偽 偽
alternativeLocalReportLocation 文字列 ローカルエージェントレポートを保存する代替場所 %PROGRAMDATA%\Citrix\WEM\Local Agent Reports D:\WEM Local Agent Reports
localReportMaxDays 整数 ローカルエージェントレポートを保持する最大日数 7 7
localReportMaxFilesPerEvent 整数 保持するローカルエージェントレポートの最大数 30 30
saveLogonDurationAnalysisToLocal ブール値 ログオン期間分析レポートをローカルエージェントレポートとして保存する 真 真
saveUpmHealthCheckToLocal ブール値 UPMヘルスチェックレポートをローカルエージェントレポートとして保存する 真 真
saveProfileContainerInsightsToLocal ブール値 プロファイルコンテナインサイトレポートをローカルエージェントレポートとして保存する 真 真
注:
カスタム設定が構成されていないか無効な場合、WEMエージェントはデフォルト設定を使用します。
基本展開エージェントの設定をカスタマイズするために、JSON形式の文字列を指定できます。例:
{
    "enableCpuSpikeProtection": true,
    "enableCpuAutoProtection": true,
    "enableIntelligentCpuOptimization": true,
}
基本展開のカスタム設定(/en-us/workspace-environment-management/service/media/wem-custom-setting-for-basic-deployment.png)

エージェント展開タイプの切り替え

展開タイプを切り替えるには、次のいずれかの方法を選択します。
  • エージェントグループポリシーを利用して、エージェントを別の展開タイプに切り替えます。詳細については、「グループポリシーの構成」を参照してください。
  • WEMヘルスチェックツールを使用して、別の展開タイプに切り替えます。

WEMログオン期間機能の使用

WEMログオン期間機能を使用する利点は次のとおりです。
  • WEMエージェントは、エージェントマシンにログオンすると、ログオン期間を分析し、レポートを自動的に生成します。
  • WEM Tool Hubを使用して、エージェントが生成したレポートを確認できます。