Share via

New-CMSettingDeployment

  • Referência
Módulo:
ConfigurationManager

Implante um objeto de política de configurações em uma coleção.

Syntax

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

Description

Implante um objeto de política de configurações em uma coleção. Por exemplo, implante uma política de gerenciamento do BitLocker ou uma política de Controle de Aplicativo do Microsoft Defender. Para criar uma agenda personalizada, use o cmdlet New-CMSchedule. Para obter uma coleção, use o cmdlet Get-CMCollection.

Exemplos

Exemplo 1: Implantar um objeto de gerenciamento do BitLocker em todos os clientes de desktop e servidor

Este exemplo obtém um objeto de configurações de gerenciamento do BitLocker por nome e armazena esse objeto na variável $setting. Em seguida, ele obtém uma coleção por nome e armazena esse objeto na variável $collection. Ele usa o cmdlet New-CMSettingDeployment para implantar o objeto de configurações de gerenciamento do BitLocker nessa coleção.

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

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

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

Exemplo 2: Implantar uma configuração Windows Defender controle de aplicativo usando uma agenda personalizada

Este exemplo também cria uma agenda personalizada usando o 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

Parâmetros

-CMSetting

Especifique um objeto settings a ser implantado.

Type:CMSettings
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Collection

Especifique um objeto collection como o destino da implantação. Para obter uma coleção, use o cmdlet Get-CMCollection.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionId

Especifique a ID da coleção como o destino da implantação.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

Especifique o nome da coleção como o destino da implantação.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-OverrideServiceWindows

Quando você adiciona esse parâmetro, o cliente pode remediar as configurações fora de uma janela de manutenção.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Schedule

Especifique um objeto schedule a ser aplicado à implantação. Para criar uma agenda personalizada, use o cmdlet New-CMSchedule.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entradas

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

Saídas

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