New-CMSettingDeployment
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.NameExemple 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 $schedParamètres
-CMSetting
Spécifiez un objet de paramètres à déployer.
- Pour la gestion BitLocker, utilisez les applets de commande Get-CMBlmSetting ou New-CMBlmSetting .
- Pour Microsoft Defender Application Control, utilisez les applets de commande Get-CMWdacSetting ou New-CMWdacSetting .
| 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