アップグレード後に非推奨のポリシー設定を削除する

最終公開日 : Nov 13, 2026
Citrix® が製品コンポーネントを非推奨にすると、関連するポリシー設定は無効になります。アップグレード後、GpoClean.ps1 を使用して、Citrix Virtual Apps and Desktops™ ポリシーからこれらの非推奨設定を特定して削除します。これには、結果として空になるポリシーも含まれます。

始める前に

スクリプトを実行する前に、以下の要件を満たしていることを確認してください。
  • Broker SDK と Group Policy Management がインストールされている、サポート対象バージョンの Citrix Virtual Apps and Desktops
  • Delivery Controller™ 上の Citrix ポリシー管理 権限
注:
スクリプトは、Citrix.Broker.Admin.V2 と Citrix.Common.GroupPolicy スナップインを自動的にロードします。

非推奨のポリシー設定を削除する

非推奨のポリシー設定を削除するには、GpoClean.ps1 を実行します。
  1. Citrix policy administration 権限を持つ Delivery Controller に GpoClean.ps1 をコピーします。
  2. Delivery Controller で PowerShell セッションを開きます。
  3. スクリプトを実行します。パラメーターは不要です。
    .\GpoClean.ps1
    注:
    設定ごとの詳細なログ記録には、-Verbose を追加します: .\GpoClean.ps1 -Verbose。
スクリプトは2つのフェーズで実行されます。
フェーズ 内容
フェーズ1 Test-BrokerDesktopPolicyを実行し、DeprecatedSettingエラーを特定し、影響を受ける各設定をNotConfiguredに設定します
フェーズ2 Test-BrokerDesktopPolicyを再実行し、構成された設定がないポリシー(PolicyHasNoSettings)を特定して削除します
すべての変更は、1回の書き込み操作で保存されます。削除された設定とポリシーの数が概要として報告されます。非推奨の設定が見つからない場合、スクリプトは変更なしで終了します。
注:
Unfilteredポリシーは、構成された設定が含まれていない場合でも、削除されることはありません。

関連コンテンツ

各リリースでの非推奨設定の詳細については、「ポリシーの変更」を参照してください。