Remove-CMClientSettingDeployment
拿掉自訂客戶端設定的特定部署。
語法
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:依標識符移除用戶端設定部署
本範例會移除將 遠端控制 用戶端設定部署至標識 碼XYZ0003F集合。
$clientSettingId = (Get-CMClientSetting -Name "Remote control").SettingsID
Remove-CMClientSettingDeployment -CollectionID 'XYZ0003F' -ClientSettingsID $clientSettingId
參數
-ClientSettingsId
指定已部署之用戶端設定的識別碼。 此識別碼是控制台中的 [設定標識符],以及 SMS_ClientSettings WMI 類別上的 SettingsID 屬性。
您可以使用 Get-CMClientSetting Cmdlet 來取得此屬性。 例如,(Get-CMClientSetting -Name "Remote control").SettingsID
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-CollectionId
指定要部署用戶端設定的集合識別碼。 這個值是標準集合識別碼格式,例如 XYZ00042
。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Force
執行命令而不要求確認。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-InputObject
指定要移除的用戶端設定部署物件。 若要取得此物件,請使用 Get-CMClientSettingDeployment Cmdlet。
類型: | IResultObject |
別名: | Deployment |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object