Start-CMAntimalwarePolicyDeployment

  • Referência
Módulo:
ConfigurationManager

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

Sintaxe

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 implementação de uma política antimalware do Microsoft System Center 2016 Endpoint Protection para os membros de uma coleção do Configuration Manager.

Para iniciar uma implementação de política, especifique a política antimalware a implementar e a coleção de dispositivos que é o destino da implementação. Especifique uma política por nome ou ID ou utilize o cmdlet Get-CMAntiMalwarePolicy para obter um objeto de política. Especifique uma coleção por nome ou ID ou utilize o cmdlet Get-CMDeviceCollection para obter um objeto de coleção. Também pode especificar um nome de implementação para implementar uma política.

Importante

A partir da versão 2107, este cmdlet foi preterido e poderá ser removido numa versão futura. Em vez disso, utilize o cmdlet New-CMAntimalwarePolicyDeployment .

Exemplos

Exemplo 1: Implementar uma política antimalware numa coleção com um ID

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

Este comando inicia a implementação de uma política denominada ExclusionsPolicy para uma coleção de dispositivos que tenha o ID SMS00023.

Exemplo 2: Implementar uma política antimalware numa coleção com nome

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

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

Parâmetros

-AntimalwarePolicy

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

Tipo:IResultObject
Aliases:Policy
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-AntimalwarePolicyId

Especifica o ID de uma política antimalware.

Tipo:String
Aliases:PolicyId
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AntimalwarePolicyName

Especifica o nome de uma política antimalware.

Tipo:String
Aliases:PolicyName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Collection

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

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-CollectionId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object