Remove-WdsClient

Remove-WdsClient

Removes a pre-staged client from AD DS or the stand-alone server device database, or clears the Pending Devices database.

语法

Parameter Set: PendingClientByStatus
Remove-WdsClient -PendingClientStatus <PendingClientStatusFlag> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: PrestagedClientByDeviceId
Remove-WdsClient -DeviceID <String> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: PrestagedClientByDeviceIdDomain
Remove-WdsClient -DeviceID <String> -Domain [-AsJob] [-CimSession <CimSession[]> ] [-DomainName <String> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: PrestagedClientByDeviceIdSearchForest
Remove-WdsClient -DeviceID <String> -SearchForest [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: PrestagedClientByDeviceName
Remove-WdsClient -DeviceName <String> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: PrestagedClientByDeviceNameDomain
Remove-WdsClient -DeviceName <String> -Domain [-AsJob] [-CimSession <CimSession[]> ] [-DomainName <String> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: PrestagedClientByDeviceNameSearchForest
Remove-WdsClient -DeviceName <String> -SearchForest [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

详细说明

The Remove-WdsClient cmdlet removes a pre-staged client from Active Directory® 域服务 (AD DS) or the stand-alone server device database, or clears the Pending Devices database.

To remove pre-staged client from AD DS, specify the name of the computer or the device ID, which is a GUID, media access control (MAC) address, or Dynamic Host Configuration Protocol (DHCP) identifier associated with the computer. You can specify a client within AD DS domain of the server that runs Windows Deployment Services, within a specified domain, or anywhere in the current AD DS forest.

To clear the Pending Devices database, specify whether to remove devices that are approved, denied, or pending.

参数

-AsJob

-CimSession<CimSession[]>

在远程会话中或在远程计算机上运行 cmdlet。输入计算机名称或会话对象，例如 New-CimSession 或 Get-CimSession cmdlet 的输出。默认为本地计算机上的当前会话。

-DeviceID<String>

Specifies the ID of the computer. This identifier is the GUID of a network interface card, a MAC address, or a DHCP unique identifier associated with the computer.

-DeviceName<String>

Specifies the name of the computer associated with the pre-staged client. This is a sAMAccountName value.

-Domain

Indicates that the cmdlet refers to pre-staged clients within the domain specified by the DomainName parameter, instead of the domain of the server that runs Windows Deployment Services or the entire forest.

-DomainName<String>

Specifies a domain name. Specify a value for this parameter only if you specify the Domain parameter.

-PendingClientStatus<PendingClientStatusFlag>

Specifies a pending client status. 此参数可接受的值如下：

-- Any
-- Approved
-- Denied
-- Pending

-SearchForest

Indicates that the cmdlet refers to pre-staged devices anywhere in the current AD DS forest. If you do not specify this parameter and do not specify the Domain parameter, the cmdlet looks for pre-staged devices in the local domain.

-ThrottleLimit<Int32>

指定可建立的用于运行此 cmdlet 的并发操作的最大数目。如果省略了此参数或输入了值 0，那么 Windows PowerShell® 将基于正在计算机上运行的 CIM cmdlet 的数目，计算 cmdlet 的最佳中止值。中止值仅适用于当前 cmdlet，而不适用于会话或计算机。

<CommonParameters>

此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

输入

输入类型是指可通过管道传送给 cmdlet 的对象的类型。

输出

输出类型是 cmdlet 所发出对象的类型。

示例

Example 1: Remove a device by using its ID from a specified domain

This command removes the pre-staged device that has the specified ID. The cmdlet searches the domain named TSQA.Contoso.com for the device.

PS C:\> Remove-WdsClient -DeviceID "5a7a1def-2e1f-4a7b-a792-ae5275b6ef92" -Domain -DomainName "TSQA.Contoso.com"

Example 2: Remove a device by using its name from a specified domain

This command removes the pre-staged device named TSQA014. The cmdlet searches the domain named TSQA.Contoso.com for the device.

PS C:\> Remove-WdsClient -DeviceName "TSQA014" -Domain -DomainName "TSQA.Contoso.com"

Example 3: Remove a device by using its ID

This command removes a pre-staged device that has the specified ID. The cmdlet searches the entire forest for the device.

PS C:\> Remove-WdsClient -DeviceID "5a7a1def-2e1f-4a7b-a792-ae5275b6ef92" -SearchForest

Example 4: Remove a device by using its name

This command removes a pre-staged device named TSQA073. The cmdlet searches the entire forest for the device.

PS C:\> Remove-WdsClient -DeviceName "TSQA073" -SearchForest

Example 5: Remove all approved devices in the local domain

This command removes pre-staged devices that have a pending status of Approved. Because the command does not specify the Domain parameter or the SearchForest parameter, it removes devices only in the local domain.

PS C:\> Remove-WdsClient -PendingClientStatus Approved

相关主题

Approve-WdsClient

Deny-WdsClient

Get-WdsClient

New-WdsClient

Set-WdsClient