Block-CMDevice
Block-CMDevice
Blocks Configuration Manager client devices.
構文
Parameter Set: SearchByNameMandatory
Block-CMDevice -DeviceName <String[]> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByIdMandatory
Block-CMDevice -DeviceId <String[]> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByValueMandatory
Block-CMDevice -InputObject <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
The Block-CMDevice cmdlet blocks one or more client devices. You must block a device from the client's assigned site. You cannot block the device from sites higher in the hierarchy. Blocked devices are ignored by the Microsoft System Center 2012 Configuration Manager hierarchy.
Block a device that you no longer trust, to prevent it from receiving client policy and to prevent System Center 2012 Configuration Manager site systems from communicating with it.
If you later change your mind, you can unblock a device that has been blocked. If you unblock an Intel Active Management Technology (AMT)-based computer that you provisioned for AMT when it was blocked, you must take additional steps before you can manage that computer again out-of-band.
For more information about unblocking a client device in System Center 2012 Configuration Manager, see Determine Whether to Block Clients in Configuration Manager (https://go.microsoft.com/fwlink/?LinkId=271116) on TechNet.
パラメーター
-DeviceId<String[]>
Specifies an array of device IDs.
エイリアス |
ResourceId |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-DeviceName<String[]>
Specifies an array of device names.
エイリアス |
Name |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-InputObject<IResultObject>
Specifies a CMDevice object. To obtain a CMDevice object, use the Get-CMDevice cmdlet.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Confirm
コマンドレットを実行する前に、ユーザーに確認を求めます。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-WhatIf
コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
例
Example 1: Block a device client
This command blocks the Configuration Manager device client named CMCEN-DIST02.
PS C:\> Block-CMDevice -DeviceName "CMCEN-DIST02"