Condividi tramite


Remove-CMClientSettingDeployment

Rimuovere una distribuzione specifica di un'impostazione client personalizzata.

Sintassi

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

Descrizione

Usare questo cmdlet per rimuovere una distribuzione specifica di un'impostazione client personalizzata. Quando si distribuiscono impostazioni personalizzate, queste sostituiscono le impostazioni client predefinite. Le impostazioni client personalizzate con priorità più alta possono anche sostituire altre impostazioni. Per altre informazioni, vedere Creare e distribuire impostazioni client personalizzate.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Rimuovere la distribuzione di un'impostazione client in base all'ID

In questo esempio viene rimossa la distribuzione delle impostazioni client di Controllo remoto nella raccolta con ID XYZ0003F.

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

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

Parametri

-ClientSettingsId

Specificare l'ID delle impostazioni client distribuite. Questo ID è l'ID impostazioni nella console e la proprietà SettingsID nella classe WMI SMS_ClientSettings .

È possibile usare il cmdlet Get-CMClientSetting per ottenere questa proprietà. Ad esempio, (Get-CMClientSetting -Name "Remote control").SettingsID

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionId

Specificare l'ID raccolta in cui vengono distribuite le impostazioni client. Questo valore è il formato id raccolta standard, ad esempio XYZ00042.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Eseguire il comando senza richiedere conferma.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare un oggetto di distribuzione delle impostazioni client da rimuovere. Per ottenere questo oggetto, usare il cmdlet Get-CMClientSettingDeployment .

Tipo:IResultObject
Alias:Deployment
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object