New-CMSettingDeployment

  • Referencia
Módulo:
ConfigurationManager

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

Syntax

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: Implementar 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 su nombre y se almacena dicho objeto en la variable $setting configuración. A continuación, obtiene una colección por su 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: Implementar una configuración Windows Defender control de aplicaciones 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 implementará.

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

-Collection

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

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

-CollectionId

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

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

-CollectionName

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

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-OverrideServiceWindows

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

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

Entradas

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

Salidas

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