Share via


Remove-CMAntimalwarePolicy

Remova uma política antimalware para proteção de ponto de extremidade.

Syntax

Remove-CMAntimalwarePolicy
      [-Force]
      -Id <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAntimalwarePolicy
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMAntimalwarePolicy
      [-Force]
      -Name <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-CMAntiMalwarePolicy remove uma política antimalware para proteção de ponto de extremidade contra Configuration Manager.

Quando você cria uma política antimalware para proteção de ponto de extremidade e a implanta em uma coleção de computadores cliente, essa política antimalware substitui a política antimalware padrão. Quando você remove uma política antimalware para proteção de ponto de extremidade, Configuration Manager aplica a política com a próxima prioridade mais alta. Se nenhuma outra política personalizada existir, ela aplicará a política antimalware padrão.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: remover uma política antimalware usando a ID

Esse comando remove a política antimalware que tem a ID 16777217.

Remove-CMAntiMalwarePolicy -Id "16777217"

Exemplo 2: remover uma política antimalware usando um caractere curinga

Esse comando remove todas as políticas antimalware que têm um nome que começa com a letra D.

Remove-CMAntiMalwarePolicy -Name "D*"

Exemplo 3: remover uma política antimalware usando a variável de objeto

O primeiro comando obtém um objeto de política antimalware que tem a ID 16777217 e o armazena na variável $AMPobj .

O segundo comando remove a política antimalware armazenada na variável.

$AMPobj = Get-CMAntiMalwarePolicy -Id "16777217"
Remove-CMAntiMalwarePolicy -InputObject $AMPobj -Force

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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). Você não pode combiná-lo com DisableWildcardHandling.

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

-Id

Especifique a ID de Configurações do objeto de política antimalware a ser removido.

Type:String
Aliases:SettingsId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifique um objeto de política antimalware a ser removido. Para obter esse objeto, use o cmdlet Get-CMAntiMalwarePolicy .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifique o nome de uma política antimalware a ser removida.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object