New-CMSettingDeployment

Implementar um objeto de política de definições numa coleção.

Sintaxe

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

Description

Implementar um objeto de política de definições numa coleção. Por exemplo, implemente uma política de gestão do BitLocker ou uma política de Controlo de Aplicações do Microsoft Defender. Para criar uma agenda personalizada, utilize o cmdlet New-CMSchedule . Para obter uma coleção, utilize o cmdlet Get-CMCollection .

Exemplos

Exemplo 1: Implementar um objeto de gestão BitLocker em todos os clientes de ambiente de trabalho e servidor

Este exemplo obtém um objeto de definições de gestão do BitLocker por nome e armazena esse objeto na variável $setting . Em seguida, obtém uma coleção por nome e armazena esse objeto na variável $collection . Utiliza o cmdlet New-CMSettingDeployment para implementar o objeto de definições de gestão 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: Implementar uma definição do Controlo de Aplicações do Windows Defender com uma agenda personalizada

Este exemplo também cria uma agenda personalizada com 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 de definições a implementar.

Tipo:CMSettings
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Collection

Especifique um objeto de coleção como o destino da implementação. Para obter uma coleção, utilize o cmdlet Get-CMCollection .

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionId

Especifique o ID da coleção como o destino da implementação.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OverrideServiceWindows

Quando adiciona este parâmetro, o cliente pode remediar as definições fora de uma janela de manutenção.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Schedule

Especifique um objeto de agendamento a aplicar à implementação. Para criar uma agenda personalizada, utilize o cmdlet New-CMSchedule .

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

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

Saídas

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