Share via

New-CMClientSettingDeployment

  • Referência
Módulo:
ConfigurationManager

Implantar uma configuração de cliente personalizada.

Syntax

New-CMClientSettingDeployment
   -Name <String>
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMClientSettingDeployment
   -Id <String>
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMClientSettingDeployment
   -InputObject <IResultObject>
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para implantar uma configuração de cliente personalizada. Quando você implanta configurações personalizadas, elas substituem as configurações padrão do cliente. As configurações personalizadas do cliente com prioridade mais alta também podem substituir outras configurações. Para obter mais informações, consulte Create and deploy custom client settings.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Implantar um objeto de configuração de cliente usando sua ID em uma coleção nomeada

New-CMClientSettingDeployment -Id "16777225" -CollectionName "General Computer Collection"

Parâmetros

-Collection

Especifique um objeto collection como o destino da implantação. Para obter esse objeto, use o cmdlet Get-CMCollection.

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

-CollectionId

Especifique uma ID da coleção para direcionar essa implantação. Esse valor é uma ID de coleção padrão, por exemplo, XYZ00042 .

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

-CollectionName

Especifique um nome de coleção para direcionar essa implantação.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

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

-Id

Especifique a ID das configurações de cliente personalizadas a implantar. Essa ID é a Configurações ID do console e a propriedade SettingsID na classe SMS_ClientSettings WMI.

Você pode usar o cmdlet Get-CMClientSetting para obter essa propriedade. Por exemplo, (Get-CMClientSetting -Name "Remote control").SettingsID

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

-InputObject

Especifique um objeto de configurações de cliente personalizado a ser implantado. Para obter esse objeto, use o cmdlet Get-CMClientSetting.

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

-Name

Especifique o nome das configurações de cliente personalizadas a implantar.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object