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 cmdlet 可阻止一个或多个客户端设备。 必须从客户端的分配站点阻止设备。 无法阻止设备来自层次结构中较高级别的网站。 Configuration Manager 层次结构将忽略被阻止的设备。 若要取消阻止设备,请使用 Unblock-CMDevice cmdlet。

备注

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\> 。 有关详细信息,请参阅 入门

示例

示例 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 cmdlet,该 cmdlet 会阻止设备对象。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

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 cmdlet。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不运行。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object