Deny-WdsClient
Deny-WdsClient
Denies approval for clients.
语法
Parameter Set: Deny0
Deny-WdsClient [-AsJob] [-CimSession <CimSession[]> ] [-RequestID <UInt32> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
详细说明
The Deny-WdsClient cmdlet denies approval for clients. Unknown clients require approval before the server that runs Windows Deployment Services boots the client in Pre-Boot Execution Environment (PXE). Use the Approve-WdsClient cmdlet to approve clients.
You can specify a single device to deny by using a request ID. The server that runs Windows Deployment Services allocates a request ID to a device. If you do not specify a client to deny, the cmdlet denies approval for all pending clients.
参数
-AsJob
别名 |
无 |
是否为必需? |
false |
位置? |
named |
默认值 |
无 |
是否接受管道输入? |
false |
是否接受通配符? |
false |
-CimSession<CimSession[]>
在远程会话中或在远程计算机上运行 cmdlet。输入计算机名称或会话对象,例如 New-CimSession 或 Get-CimSession cmdlet 的输出。默认为本地计算机上的当前会话。
别名 |
Session |
是否为必需? |
false |
位置? |
named |
默认值 |
无 |
是否接受管道输入? |
false |
是否接受通配符? |
false |
-RequestID<UInt32>
Specifies the request ID that the server that runs Windows Deployment Services allocates to a device in the Pending Device database. To find the Request ID, use the Get-WdsClient cmdlet and look for the RequestId property of the client. If you do not specify this parameter, the cmdlet denies all devices.
别名 |
无 |
是否为必需? |
false |
位置? |
named |
默认值 |
无 |
是否接受管道输入? |
True (ByValue, ByPropertyName) |
是否接受通配符? |
false |
-ThrottleLimit<Int32>
指定可建立的用于运行此 cmdlet 的并发操作的最大数目。如果省略了此参数或输入了值 0
,那么 Windows PowerShell® 将基于正在计算机上运行的 CIM cmdlet 的数目,计算 cmdlet 的最佳中止值。中止值仅适用于当前 cmdlet,而不适用于会话或计算机。
别名 |
无 |
是否为必需? |
false |
位置? |
named |
默认值 |
无 |
是否接受管道输入? |
false |
是否接受通配符? |
false |
<CommonParameters>
此 cmdlet 支持通用参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
输入
输入类型是指可通过管道传送给 cmdlet 的对象的类型。
输出
输出类型是 cmdlet 所发出对象的类型。
示例
Example 1: Deny approval for all pending clients
This command denies approval for all pending pre-staged clients.
PS C:\> Deny-WdsClient
Example 2: Deny approval for a pending client
This command denies approval for the pre-staged client that has the specified request ID.
PS C:\> Deny-WdsClient -RequestID 5