Compartir a través de

New-CMSettingDeployment

  • Referencia
Módulo:
ConfigurationManager

Implementar un objeto de directiva de configuración en una colección.

Sintaxis

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

Description

Implementar un objeto de directiva de configuración en una colección. Por ejemplo, implemente una directiva de administración de BitLocker o una directiva de Control de aplicaciones de Microsoft Defender. Para crear una programación personalizada, use el cmdlet New-CMSchedule . Para obtener una colección, use el cmdlet Get-CMCollection .

Ejemplos

Ejemplo 1: Implementación de un objeto de administración de BitLocker en todos los clientes de escritorio y servidor

En este ejemplo se obtiene un objeto de configuración de administración de BitLocker por nombre y se almacena ese objeto en la variable $setting . A continuación, obtiene una colección por nombre y almacena ese objeto en la variable $collection . Usa el cmdlet New-CMSettingDeployment para implementar el objeto de configuración de administración de BitLocker en esa colección.

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

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

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

Ejemplo 2: Implementación de una configuración de Control de aplicaciones de Windows Defender mediante una programación personalizada

En este ejemplo también se crea una programación personalizada mediante el 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 un objeto de configuración que se va a implementar.

Tipo:CMSettings
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Collection

Especifique un objeto de colección como destino para la implementación. Para obtener una colección, use el cmdlet Get-CMCollection .

Tipo:IResultObject
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CollectionId

Especifique el identificador de la colección como destino para la implementación.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CollectionName

Especifique el nombre de la colección como destino de la implementación.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OverrideServiceWindows

Al agregar este parámetro, el cliente puede corregir la configuración fuera de una ventana de mantenimiento.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Schedule

Especifique un objeto de programación que se aplicará a la implementación. Para crear una programación personalizada, use el cmdlet New-CMSchedule .

Tipo:IResultObject
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

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

Salidas

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