New-CMSettingDeployment

  • Référence
Module:
ConfigurationManager

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.

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