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.
- Para a gestão do BitLocker, utilize os cmdlets Get-CMBlmSetting ou New-CMBlmSetting .
- Para o Controlo de Aplicações do Microsoft Defender, utilize os cmdlets Get-CMWdacSetting ou New-CMWdacSetting .
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