New-CMSettingDeployment
Déployez un objet de stratégie de paramètres sur une collection.
Syntax
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 sur 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 la cmdlet New-CMSchedule. Pour obtenir une collection, utilisez la cmdlet Get-CMCollection.
Exemples
Exemple 1 : Déployer un objet de gestion BitLocker sur tous les clients de bureau et de serveur
Cet exemple obtient un objet de paramètres de gestion BitLocker par son nom et stocke cet objet dans $setting variable. Il obtient ensuite une collection par son nom et stocke cet objet dans la $collection variable. Il utilise la cmdlet 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 Windows Defender Application Control à l’aide d’une planification personnalisée
Cet exemple crée également une planification personnalisée à l’aide de l’cmdlet 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.
- Pour la gestion de BitLocker, utilisez les cmdlets Get-CMBlmSetting ou New-CMBlmSetting.
- Pour Microsoft Defender Application Control, utilisez les cmdlets Get-CMWdacSetting ou New-CMWdacSetting.
Type: | CMSettings |
Position: | 1 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Collection
Spécifiez un objet de collection comme cible pour le déploiement. Pour obtenir une collection, utilisez la cmdlet Get-CMCollection.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Spécifiez l’ID de la collection comme cible pour le déploiement.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Spécifiez le nom de la collection comme cible du déploiement.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-DisableWildcardHandling
Ce paramètre traite les caractères génériques comme des valeurs littérales. Vous ne pouvez pas la combiner avec ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Schedule
Spécifiez un objet de planification à appliquer au déploiement. Pour créer une planification personnalisée, utilisez la cmdlet New-CMSchedule.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Microsoft.ConfigurationManagement.PowerShell.Cmdlets.EP.SimplifiedSettings.CMSettings
Sorties
Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment