Share via

Remove-CMClientSettingDeployment

  • Referência
Módulo:
ConfigurationManager

Remova uma implantação específica de uma configuração de cliente personalizada.

Syntax

Remove-CMClientSettingDeployment
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMClientSettingDeployment
      -CollectionId <String>
      -ClientSettingsId <String>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Use este cmdlet para remover uma implantação específica de 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: Remover uma implantação de configuração de cliente por ID

Este exemplo remove a implantação das configurações do cliente de controle remoto para a coleção com ID XYZ0003F.

$clientSettingId = (Get-CMClientSetting -Name "Remote control").SettingsID

Remove-CMClientSettingDeployment -CollectionID 'XYZ0003F' -ClientSettingsID $clientSettingId

Parâmetros

-ClientSettingsId

Especifique a ID das configurações de cliente implantadas. 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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionId

Especifique a ID da coleção para a qual as configurações do cliente são implantadas. Esse valor é o formato padrão de ID da coleção, por exemplo, XYZ00042 .

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

-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

-Força

Execute o comando sem pedir confirmação.

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

-InputObject

Especifique um objeto de implantação de configurações de cliente a ser removido. Para obter esse objeto, use o cmdlet Get-CMClientSettingDeployment.

Type:IResultObject
Aliases:Deployment
Position:Named
Default value:None
Accept pipeline input:True
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