Share via


Remove-CMSettingDeployment

Remova uma implantação para um objeto de política de configurações.

Syntax

Remove-CMSettingDeployment
      [-CMSettingsDeployment] <SettingsDeployment>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [<CommonParameters>]

Description

Exclua uma implantação para um objeto de política de configurações. Por exemplo, remova a implantação de uma política de gerenciamento do BitLocker ou de uma política de Controle de Aplicativo do Microsoft Defender.

Exemplos

Exemplo 1: Remover todas as implantações para um objeto de configurações de gerenciamento do BitLocker

Este exemplo primeiro obtém um objeto de configurações de gerenciamento do BitLocker. Em seguida, ele usa o operador de pipe para obter todas as implantações para esse objeto de política e exclui essas implantações.

Get-CMBlmSetting -Name "My BitLocker settings" | Get-CMSettingDeployment | Remove-CMSettingDeployment

Exemplo 2: Remover todas as implantações para uma coleção específica para um objeto de configuração do Controle de Aplicativos do Microsoft Defender

Este exemplo primeiro obtém um objeto de configurações do Controle de Aplicativo do Microsoft Defender. Em seguida, ele usa o operador de pipe para obter todas as implantações para esse objeto de política. A cláusula Where-Object filtra a lista de implantações para aquelas para a coleção Todos os Clientes de Desktop e Servidor, e o andr exclui essas implantações.

Get-CMWdacSetting -Name "My App Control settings" | Get-CMSettingDeployment | Where-Object { $_.CollectionId -eq (Get-CMCollection -Name "All Desktop and Server Clients").CollectionId } | Remove-CMSettingDeployment

Parâmetros

-CMSettingsDeployment

Especifique o objeto de implantação de configurações a ser configurada. Para obter o objeto de implantação, use o cmdlet Get-CMSettingDeployment.

Type:SettingsDeployment
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Força

Execute o comando sem pedir confirmação.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entradas

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

Saídas

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