Share via


Start-CMAntimalwarePolicyDeployment

(Preterido) Inicia a implantação de uma política antimalware para os membros de uma coleção Configuration Manager.

Syntax

Start-CMAntimalwarePolicyDeployment
     -AntimalwarePolicy <IResultObject>
     -Collection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMAntimalwarePolicyDeployment
     -AntimalwarePolicy <IResultObject>
     -CollectionId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMAntimalwarePolicyDeployment
     -AntimalwarePolicy <IResultObject>
     -CollectionName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMAntimalwarePolicyDeployment
     -AntimalwarePolicyId <String>
     -CollectionId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMAntimalwarePolicyDeployment
     -AntimalwarePolicyId <String>
     -CollectionName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMAntimalwarePolicyDeployment
     -AntimalwarePolicyId <String>
     -Collection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMAntimalwarePolicyDeployment
     -AntimalwarePolicyName <String>
     -CollectionId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMAntimalwarePolicyDeployment
     -AntimalwarePolicyName <String>
     -CollectionName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMAntimalwarePolicyDeployment
     -AntimalwarePolicyName <String>
     -Collection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

O cmdlet Start-CMAntimalwarePolicyDeployment inicia a implantação de uma política antimalware do Microsoft System Center 2016 Endpoint Protection para os membros de uma coleção configuration Manager.

Para iniciar uma implantação de política, especifique a política antimalware a ser implantada e o conjunto de dispositivos que é o destino da implantação. Especifique uma política por nome ou por ID ou use o cmdlet Get-CMAntiMalwarePolicy para obter um objeto de política. Especifique uma coleção por nome ou por ID ou use o cmdlet Get-CMDeviceCollection para obter um objeto de coleção. Você também pode especificar um nome de implantação para implantar uma política.

Importante

A partir da versão 2107, esse cmdlet é preterido e pode ser removido em uma versão futura. Em vez disso, use o cmdlet New-CMAntimalwarePolicyDeployment.

Exemplos

Exemplo 1: Implantar uma política antimalware em uma coleção usando uma ID

PS XYZ:\> Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyName "ExclusionsPolicy" -CollectionId "SMS00023"

Este comando inicia a implantação de uma política chamada ExclusionsPolicy para um conjunto de dispositivos que tem a ID SMS00023.

Exemplo 2: Implantar uma política antimalware em uma coleção nomeada

PS XYZ:\> Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyName "ExclusionsPolicy" -CollectionName "SouthOffice"

Este comando inicia a implantação de uma política chamada ExclusionsPolicy para uma coleção de dispositivos chamada SouthOffice.

Parâmetros

-AntimalwarePolicy

Especifica um objeto de política antimalware no Configuration Manager. Para obter um objeto de política antimalware, use o cmdlet Get-CMAntiMalwarePolicy.

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

-AntimalwarePolicyId

Especifica a ID de uma política antimalware.

Type:String
Aliases:PolicyId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AntimalwarePolicyName

Especifica o nome de uma política antimalware.

Type:String
Aliases:PolicyName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Collection

Especifica um objeto de conjunto de dispositivos do Configuration Manager. Para obter um objeto de coleção de dispositivos, use Get-CMDeviceCollection.

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

-CollectionId

Especifica a ID de uma coleção de dispositivos.

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

-CollectionName

Especifica o nome de uma coleção de dispositivos.

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
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

-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

-WhatIf

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

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object