Remove-CMSettingDeployment

  • リファレンス
モジュール:
ConfigurationManager

設定ポリシー オブジェクトの展開を削除します。

構文

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