Remove-CMSettingDeployment
設定ポリシー オブジェクトの展開を削除します。
構文
Remove-CMSettingDeployment
[-CMSettingsDeployment] <SettingsDeployment>
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
説明
設定ポリシー オブジェクトの展開を削除します。 たとえば、BitLocker 管理ポリシーまたは Microsoft Defender アプリケーション制御ポリシーの展開を削除します。
例
例 1: BitLocker 管理設定オブジェクトのすべての展開を削除する
この例では、最初に BitLocker 管理設定オブジェクトを取得します。 その後、パイプ演算子を使用して、そのポリシー オブジェクトのすべてのデプロイを取得し、それらのデプロイを削除します。
Get-CMBlmSetting -Name "My BitLocker settings" | Get-CMSettingDeployment | Remove-CMSettingDeployment
例 2: Microsoft Defender アプリケーション制御設定オブジェクトの特定のコレクションへの展開をすべて削除する
この例では、最初に Microsoft Defender アプリケーションコントロール設定オブジェクトを取得します。 その後、パイプ演算子を使用して、そのポリシー オブジェクトのすべてのデプロイを取得します。 Where-Object 句は、すべてのデスクトップおよびサーバー クライアント コレクションへの展開の一覧をフィルター処理し、それらのデプロイを削除します。
Get-CMWdacSetting -Name "My App Control settings" | Get-CMSettingDeployment | Where-Object { $_.CollectionId -eq (Get-CMCollection -Name "All Desktop and Server Clients").CollectionId } | Remove-CMSettingDeployment
パラメーター
-CMSettingsDeployment
構成する設定デプロイ オブジェクトを指定します。 デプロイ オブジェクトを取得するには、 Get-CMSettingDeployment コマンドレットを 使用します。
型: | SettingsDeployment |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
確認を求めずにコマンドを実行します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment
出力
Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment