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