Remove-CMClientSettingDeployment
カスタム クライアント設定の特定の展開を削除します。
構文
Remove-CMClientSettingDeployment
[-Force]
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMClientSettingDeployment
-CollectionId <String>
-ClientSettingsId <String>
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットを使用して、カスタム クライアント設定の特定の展開を削除します。 カスタム設定を展開すると、既定のクライアント設定が上書きされます。 優先度が高いカスタム クライアント設定は、他の設定よりも優先される場合があります。 詳細については、「カスタム クライアント設定の 作成と展開」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 1: ID によるクライアント設定の展開を削除する
この例では、ID XYZ0003Fを使用して、リモート コントロール クライアント設定の展開をコレクションに削除します。 ****
$clientSettingId = (Get-CMClientSetting -Name "Remote control").SettingsID
Remove-CMClientSettingDeployment -CollectionID 'XYZ0003F' -ClientSettingsID $clientSettingId
パラメーター
-ClientSettingsId
展開するクライアント設定の ID を指定します。 この ID は 、コンソール設定 ID、 および WMI クラスのSettingsID プロパティSMS_ClientSettingsです。
Get-CMClientSetting コマンドレットを使用して、このプロパティを取得できます。 たとえば、(Get-CMClientSetting -Name "Remote control").SettingsID
のように指定します。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
クライアント設定を展開するコレクション ID を指定します。 この値は、たとえば、標準コレクション ID 形式です XYZ00042
。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
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
削除するクライアント設定展開オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMClientSettingDeployment コマンドレットを使用 します。
Type: | IResultObject |
Aliases: | Deployment |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object