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