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 cmdlet。

类型:SettingsDeployment
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Force

运行命令而不要求确认。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment

输出

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment