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