Share via

Remove-CMClientSettingDeployment

  • 參考
模組:
ConfigurationManager

移除自訂用戶端設定的特定部署。

Syntax

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

Description

使用此 Cmdlet 可移除自訂用戶端設定的特定部署。 當您部署自訂設定時，會覆寫預設的用戶端設定。 具有較高優先順序的自訂用戶端設定也可以覆寫其他設定。 如需詳細資訊，請參閱 建立及部署自訂用戶端設定。

注意

從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請參閱 快速入門。

範例

範例1：依識別碼移除用戶端設定部署

此範例會移除 ID 為XYZ0003F的集合的遠端控制用戶端設定部署。

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

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

參數

-ClientSettingsId

指定所部署之用戶端設定的識別碼。 這個識別碼是主控台中的設定識別碼，也是SMS_ClientSettings WMI 類別上的SettingsID屬性。

您可以使用 CMClientSetting Cmdlet 取得此屬性。 例如，(Get-CMClientSetting -Name "Remote control").SettingsID

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

-CollectionId

指定要部署用戶端設定的集合識別碼。 這個值是標準的集合 ID 格式，例如 XYZ00042 。

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

-Confirm

執行 Cmdlet 之前提示您確認。

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

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。

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

-Force

在不要求確認的情況下執行命令。

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

-ForceWildcardHandling

這個參數會處理萬用字元，而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。

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

-InputObject

指定要移除的用戶端設定部署物件。 若要取得此物件，請使用 CMClientSettingDeployment Cmdlet。

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

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。

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

輸入

ConfigurationManagement IResultObject

輸出

系統.物件