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 コマンドレットを使用 します。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください

例 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

コマンドレットを実行する前に確認メッセージを表示します。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DeviceId

デバイスの ID を指定します。

Type:String
Aliases:ResourceId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeviceName

デバイスの名前を指定します。

Type:String
Aliases:Name
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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

デバイス オブジェクトを指定します。 デバイス オブジェクトを取得するには 、Get-CMDevice コマンドレットを使用 します。

Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object