New-CMSettingDeployment
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á.
- Para la administración de BitLocker, use los cmdlets Get-CMBlmSetting o New-CMBlmSetting.
- Para el Control de aplicaciones de Microsoft Defender, use los cmdlets Get-CMWdacSetting o New-CMWdacSetting.
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