Partager via

New-CMSettingDeployment

  • Référence
Module:
ConfigurationManager

Déployez un objet de stratégie de paramètres dans une collection.

Syntaxe

New-CMSettingDeployment
   [-CMSetting] <CMSettings>
   [-Schedule <IResultObject>]
   [-OverrideServiceWindows]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Déployez un objet de stratégie de paramètres dans une collection. Par exemple, déployez une stratégie de gestion BitLocker ou une stratégie Microsoft Defender Application Control. Pour créer une planification personnalisée, utilisez l’applet de commande New-CMSchedule . Pour obtenir une collection, utilisez l’applet de commande Get-CMCollection .

Exemples

Exemple 1 : Déployer un objet de gestion BitLocker sur tous les clients de bureau et serveur

Cet exemple obtient un objet de paramètres de gestion BitLocker par nom et stocke cet objet dans la variable $setting . Il obtient ensuite une collection par nom et stocke cet objet dans la variable $collection . Il utilise l’applet de commande New-CMSettingDeployment pour déployer l’objet de paramètres de gestion BitLocker dans cette collection.

$setting = Get-CMBlmSetting -Name "My BitLocker settings"

$collection = Get-CMCollection -Name "All Desktop and Server Clients"

New-CMSettingDeployment -CMSetting $setting -CollectionName $collection.Name

Exemple 2 : Déployer un paramètre de contrôle d’application Windows Defender à l’aide d’une planification personnalisée

Cet exemple crée également une planification personnalisée à l’aide de l’applet de commande New-CMSchedule .

$setting = Get-CMWdacSetting -Name "My App Control settings"

$collection = Get-CMCollection -Name "All Desktop and Server Clients"

$sched = New-CMSchedule -Start ((Get-Date).AddDays(-30)).ToString() -RecurCount 7 -RecurInterval Minutes

$dep = New-CMSettingDeployment -CMSetting $setting -Collection $collection -Schedule $sched

Paramètres

-CMSetting

Spécifiez un objet de paramètres à déployer.

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

-Collection

Spécifiez un objet de collection comme cible pour le déploiement. Pour obtenir une collection, utilisez l’applet de commande Get-CMCollection .

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

-CollectionId

Spécifiez l’ID de la collection comme cible pour le déploiement.

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

-CollectionName

Spécifiez le nom de la collection comme cible pour le déploiement.

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

-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

-OverrideServiceWindows

Lorsque vous ajoutez ce paramètre, le client peut corriger les paramètres en dehors d’une fenêtre de maintenance.

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

-Schedule

Spécifiez un objet de planification à appliquer au déploiement. Pour créer une planification personnalisée, utilisez l’applet de commande New-CMSchedule .

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

Entrées

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.EP.SimplifiedSettings.CMSettings

Sorties

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