New-CMClientSettingDeployment
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