Remove-CMClientSettingDeployment

  • Riferimento
Modulo:
ConfigurationManager

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

Utilizzare 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 una priorità più alta possono anche sostituire altre impostazioni. Per ulteriori 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 ulteriori informazioni, vedere Introduzione.

Esempio

Esempio 1: Rimuovere una distribuzione di impostazioni client in base all'ID

In questo esempio viene rimossa la distribuzione delle impostazioni del client di controllo remoto nell'insieme 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 SMS_ClientSettings WMI.

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

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

-CollectionId

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

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-DisableWildcardHandling

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

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

-Force

Eseguire il comando senza chiedere conferma.

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

-ForceWildcardHandling

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

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

-InputObject

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

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

-WhatIf

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

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object