/approve-AutoAddDevices

Applies To: Windows Server 2008, Windows Server 2008 R2

Approves computers that are pending administrative approval. When the Auto-Add policy is enabled, administrative approval is required before unknown computers (those that are not prestaged) can install an image. You can enable this policy using the PXE Response tab of the server’s properties page.

Syntax

WDSUTIL [Options] /Approve-AutoAddDevices [/Server:<Server name>] /RequestId:{<Request ID>| ALL} [/MachineName:<Device name>] [/OU:<DN of OU>] 
[/User:<Domain\User | User@Domain>] [/JoinRights:{JoinOnly | Full}] [/JoinDomain:{Yes | No}] [/ReferralServer:<Server name>] [/BootProgram:<Relative path>] [/WdsClientUnattend:<Relative path>] [/BootImagePath:<Relative path>]

Parameters

Parameter Description

[/Server:<Server name>]

Specifies the name of the server. This can be either the NetBIOS name or the fully qualified domain name (FQDN). If a server name is not specified, the local server will be used.

/RequestId:{Request ID | ALL}

Specifies the request ID assigned to the pending computer. Specify ALL to approve all pending computers.

[/MachineName:<Device name>]

Specifies the name of the computer to be added. You cannot use this option when approving all computers.

[/OU:<DN of OU>]

Specifies the distinguished name of the organizational unit (OU) where the computer account object should be created. For example: OU=MyOU,CN=Test,DC=Domain,DC=com. The default location is the container of the default computer.

[/User:<Domain\User | User@Domain>]

Sets permissions on the computer account object to assign the specified user the necessary rights.

[/JoinRights:{JoinOnly | Full}]

Specifies the type of rights to be assigned to the specified user.

  • JoinOnly requires the administrator to reset the computer account before the user can join the computer to the domain.

  • Full gives full access to the user, which includes the right to join the computer to the domain.

[/JoinDomain:{Yes | No}]

Specifies whether or not the computer should be joined to the domain as this computer account during operating system installation. The default value is Yes.

[/ReferralServer:<Server name>]

Specifies the name of the server to be contacted to download the network boot program and boot image by using Trivial File Transfer Protocol (TFTP).

[/BootProgram:<Relative path>]

Specifies the relative path from the RemoteInstall folder to the network boot program that this computer should receive. For example: boot\x86\pxeboot.com.

[/WdsClientUnattend:<Relative path>]

Specifies the relative path from the RemoteInstall folder to the unattend file that automates the Windows Deployment Services client.

[/BootImagePath:<Relative path>]

Specifies the relative path from the RemoteInstall folder to the boot image that this computer should receive.

Examples

To approve the computer with a RequestId of 12, type:

WDSUTIL /Approve-AutoAddDevices /RequestId:12

To approve the computer with a RequestID of 20 and deploy the image with the specified settings, type:

WDSUTIL /Approve-AutoAddDevices /RequestId:20 /MachineName:Computer1 /OU:"OU=Test,CN=Company,DC=Domain,DC=Com" /User:Domain\User1 
/JoinRights:Full /ReferralServer:MyWDSServer /BootProgram:boot\x86\pxeboot.n12 /WdsClientUnattend:WDSClientUnattend\Unattend.xml /BootImagePath:boot\x86\images/boot.wim

To approve all pending computers, type:

WDSUTIL /Verbose /Approve-AutoAddDevices /RequestId:ALL

Additional references

Command-Line Syntax Key

/delete-AutoAddDevices

/get-AutoAddDevices

/reject-AutoAddDevices