Remove-CMDevice
Configuration Manager からクライアント デバイスを削除します。
構文
Remove-CMDevice
[-Force]
[-InputObject] <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Remove-CMDevice
[-Force]
[-Name] <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Remove-CMDevice
[-Force]
[-ResourceId] <Int32>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]説明
Remove-CMDevice コマンドレットは、1 つ以上の Configuration Manager クライアント デバイスを削除します。 クライアントをアンインストールする場合、またはコレクションからクライアントを削除する場合は、クライアントを削除しないでください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: 名前でデバイスを削除する
PS XYZ:\> Remove-CMDevice -DeviceName "WIN10-86-33"このコマンドは、WIN10-86-33 という名前のデバイスを削除します。
例 2: デバイスを取得して削除する
PS XYZ:\> Get-CMDevice -Name "TestVLAN-VNEXT" | Remove-CMDeviceこのコマンドは、TestVLAN-VNEXT という名前のデバイス オブジェクトを取得し、パイプライン演算子を使用してオブジェクトを Remove-CMDevice に渡し、デバイス オブジェクトを削除します。
パラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InputObject
デバイス オブジェクトを指定します。 デバイス オブジェクトを取得するには、 Get-CMDevice コマンドレットを使用します。
| 型: | IResultObject |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Name
デバイスの名前を指定します。
| 型: | String |
| Aliases: | DeviceName |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | True |
-ResourceId
デバイスのリソース ID を指定します。
| 型: | Int32 |
| Aliases: | Id, DeviceId |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object