Partager via

Start-CMAntimalwarePolicyDeployment

  • Référence
Module:
ConfigurationManager

(Déconseillé) Démarre le déploiement d’une stratégie anti-programme malveillant sur les membres d’un regroupement Configuration Manager.

Syntaxe

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

L’applet de commande Start-CMAntimalwarePolicyDeployment démarre le déploiement d’une stratégie de logiciel anti-programme malveillant Microsoft System Center 2016 Endpoint Protection pour les membres d’une collection Configuration Manager.

Pour démarrer un déploiement de stratégie, spécifiez la stratégie anti-programme malveillant à déployer et le regroupement d’appareils qui est la destination du déploiement. Spécifiez une stratégie par nom ou par ID, ou utilisez l’applet de commande Get-CMAntiMalwarePolicy pour obtenir un objet de stratégie. Spécifiez une collection par nom ou par ID, ou utilisez l’applet de commande Get-CMDeviceCollection pour obtenir un objet de collection. Vous pouvez également spécifier un nom de déploiement pour déployer une stratégie.

Importante

À compter de la version 2107, cette applet de commande est déconseillée et peut être supprimée dans une version ultérieure. Utilisez plutôt l’applet de commande New-CMAntimalwarePolicyDeployment .

Exemples

Exemple 1 : Déployer une stratégie anti-programme malveillant sur un regroupement à l’aide d’un ID

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

Cette commande démarre le déploiement d’une stratégie nommée ExclusionsPolicy sur un regroupement d’appareils dont l’ID est SMS00023.

Exemple 2 : Déployer une stratégie anti-programme malveillant sur une collection nommée

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

Cette commande démarre le déploiement d’une stratégie nommée ExclusionsPolicy sur un regroupement d’appareils nommé SouthOffice.

Paramètres

-AntimalwarePolicy

Spécifie un objet de stratégie anti-programme malveillant dans Configuration Manager. Pour obtenir un objet de stratégie anti-programme malveillant, utilisez l’applet de commande Get-CMAntiMalwarePolicy .

Type:IResultObject
Alias:Policy
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-AntimalwarePolicyId

Spécifie l’ID d’une stratégie anti-programme malveillant.

Type:String
Alias:PolicyId
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AntimalwarePolicyName

Spécifie le nom d’une stratégie anti-programme malveillant.

Type:String
Alias:PolicyName
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Collection

Spécifie un objet de collection d’appareils Configuration Manager. Pour obtenir un objet de collection d’appareils, utilisez Get-CMDeviceCollection.

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-CollectionId

Spécifie l’ID d’un regroupement d’appareils.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CollectionName

Spécifie le nom d’un regroupement d’appareils.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object