Configures the settings for a Windows Deployment Services server.
Syntax
WDSUTIL [Options] /Set-Server [/Server:<Server name>] [/Authorize:{Yes | No}] [/RogueDetection:{Yes | No}] [/AnswerClients:{All | Known | None}] [/ResponseDelay:<Time in seconds>] [/AllowN12ForNewClients:{Yes | No}] [/ArchitectureDiscovery:{Yes | No}] [/ResetBootProgram:{Yes | No}] [/DefaultX86X64ImageType:{x86 | x64 | Both}] [/UseDhcpPorts:{Yes | No}] [/DhcpOption60:{Yes | No}] [/RpcPort:<Port number>] [/BootProgram:<Relative path>] /Architecture:{x86 | ia64 | x64} [/N12BootProgram:<Relative path>] /Architecture:{x86 | ia64 | x64} [/BootImage:<Relative path>] /Architecture:{x86 | ia64 | x64} [/PreferredDC:<DC Name>] [/PreferredGC:<GC Name>] [/PrestageUsingMAC:{Yes | No}] [/NewMachineNamingPolicy:<Policy>] [/NewMachineOU] [/Type:{ServerDomain | UserDomain | UserOU | Custom}] [/OU:<Domain name of OU>] [/DomainSearchOrder:{GCOnly | DCFirst}] [/NewMachineDomainJoin:{Yes | No}] [/OSCMenuName:<Name>] [/WdsClientLogging] [/Enabled:{Yes | No}] [/LoggingLevel:{None | Errors | Warnings | Info}] [/WdsUnattend] [/Policy:{Enabled | Disabled}] [/CommandlinePrecedence:{Yes | No}] [/File:<Path>] /Architecture:{x86 | ia64 | x64} [/AutoAddPolicy] [/Policy:{AdminApproval | Disabled}] [/PollInterval:{Time in seconds}] [/MaxRetry:{Retries}] [/Message:<Message>] [/RetentionPeriod] [/Approved:<Time in days>] [/Others:<Time in days>] [/AutoAddSettings] /Architecture:{x86 | ia64 | x64} [/BootProgram:<Relative path>] [/ReferralServer:<Server name> [/WdsClientUnattend:<Relative path>] [/BootImage:<Relative path>] [/User:<Owner>] [/JoinRights:{JoinOnly | Full}] [/JoinDomain:{Yes | No}] [/BindPolicy] [/Policy:{Include | Exclude}] [/Add] /Address:<IP or MAC address> /AddressType:{IP | MAC} [/Remove] /Address:<IP or MAC address> /AddressType:{IP | MAC} [/RefreshPeriod:<Time in seconds>] [/BannedGuidPolicy] [/Add] /Guid:<GUID> [/Remove] /Guid:<GUID> [/BcdRefreshPolicy] [/Enabled:{Yes | No}] [/RefreshPeriod:<Time in minutes>] [/Transport] [/ObtainIpv4From:{Dhcp | Range}] [/Start:<Start Ip Address>] [/End:<End Ip Address>] [/StartPort:<Start Port> [/EndPort:<Start Port> [/Profile:{10Mbps | 100Mbps | 1Gbps | Custom}] [/ForceNative]
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 no server name is specified, the local server will be used. |
||||||||||||||||||
[/Authorize:{Yes | No}] |
Sets the authorization mode of the server in Dynamic Host Control Protocol (DHCP). |
||||||||||||||||||
[/RogueDetection:{Yes | No}] |
Enables or disables DHCP rogue detection. |
||||||||||||||||||
[/AnswerClients:{All | Known | None}] |
Sets the answer mode for the Pre-Boot Execution Environment (PXE) server. If you set this value to Known, a device must be prestaged before it will be answered. |
||||||||||||||||||
[/ResponseDelay:<Time in seconds>] |
The amount of time that a PXE Server must wait before answering a booting client. This setting does not apply to prestaged devices. |
||||||||||||||||||
[/AllowN12ForNewClients:{Yes | No}] |
Specifies that any unknown client will receive a boot program that does not require the user to press the F12 key to initiate a network boot. Known clients will receive the boot program specified for the devices or, if not specified, the server for the server. |
||||||||||||||||||
[/ArchitectureDiscovery:{Yes | No}] |
Enables or disables the network boot program for architecture discovery. This facilitates the discovery of x64-based clients that do not broadcast their architecture correctly. |
||||||||||||||||||
[/ResetBootProgram:{Yes | No}] |
Determines whether the boot path will be erased for a client that has just booted without requiring an F12 key press. |
||||||||||||||||||
[/DefaultX86X64ImageType: {x86 | x64 | Both}] |
Controls which boot images will be shown to x64-based clients. |
||||||||||||||||||
[/UseDhcpPorts:{Yes | No}] |
Specifies whether or not the PXE server should attempt to bind to the DHCP port, TCP port 67. If DHCP and Windows Deployment Services are running on the same computer, you should set this option to No to enable the DHCP server to utilize the port, and set the /DhcpOption60 parameter to Yes. The default setting for this value is Yes. |
||||||||||||||||||
[/DhcpOption60:{Yes | No}] |
Specifies whether DHCP option 60 should be configured for PXE support. If DHCP and Windows Deployment Services are running on the same server, set this option to Yes and set the /UseDhcpPorts option to No. The default setting for this value is No. |
||||||||||||||||||
[/RpcPort:<Port number>] |
Specifies the TCP port number to be used to service client requests. |
||||||||||||||||||
[/BootProgram:<Relative path>] /Architecture:{x86 | ia64 | x64} |
Specifies the relative path to the boot program in the RemoteInstall folder (for example, boot\x86\pxeboot.n12), and specifies the architecture of the boot program. |
||||||||||||||||||
[/N12BootProgram:<Relative path>] /Architecture:{x86 | ia64 | x64} |
Specifies the relative path to the boot program that does not require pressing the F12 key (for example, boot\x86\pxeboot.n12), and specifies the architecture of the boot program. |
||||||||||||||||||
[/BootImage:<Relative path>] /Architecture:{x86 | ia64 | x64} |
Specifies the relative path to the boot image that booting clients should receive, and specifies the architecture of the boot image. |
||||||||||||||||||
[/PreferredDC:<DC Name>] |
Specifies the name of the domain controller that Windows Deployment Services PXE Provider (BINL) should use. This can be either the NetBIOS name or the FQDN. |
||||||||||||||||||
[/PreferredGC:<GC Name>] |
Specifies the name of the global catalog server that Windows Deployment Services PXE Provider (BINL) should use. This can be either the NetBIOS name or the FQDN. |
||||||||||||||||||
[/PrestageUsingMAC:{Yes | No}] |
Specifies whether Windows Deployment Services, when creating computer accounts in the directory service, should use the MAC address rather than the GUID/UUID as the known identifier for the device. |
||||||||||||||||||
[/NewMachineNamingPolicy:<Policy>] |
Specifies the format to be used when generating client computer names. |
||||||||||||||||||
[/NewMachineOU] |
Specifies the location in the directory service where client computer accounts will be created.
|
||||||||||||||||||
[/DomainSearchOrder:{GCOnly | DCFirst}] |
Specifies the policy for searching computer accounts in the directory service (global catalog or domain controller). |
||||||||||||||||||
[/NewMachineDomainJoin:{Yes | No}] |
Specifies whether or not a new computer (for example, one that is not already prestaged in Active Directory Domain Services) should be joined to the domain during installation. The default setting is Yes. |
||||||||||||||||||
[/WdsClientLogging] |
Specifies the logging level for the server.
|
||||||||||||||||||
[/WdsUnattend] |
These settings control the unattended installation behavior of Windows Deployment Services client.
|
||||||||||||||||||
[/AutoAddPolicy] |
These settings control the Auto-Add policy.
|
||||||||||||||||||
[/AutoAddSettings] |
Specifies the default settings to be applied to each device.
|
||||||||||||||||||
[/BindPolicy] |
Configures the server interface bind policy.
|
||||||||||||||||||
[/RefreshPeriod:<Time in seconds>] |
Specifies the interval at which the server will update its configuration settings. |
||||||||||||||||||
[/BannedGuidPolicy] |
Manages the list of banned GUIDs using the options in the following table:
|
||||||||||||||||||
[/BcdRefreshPolicy] |
Configures the settings for refreshing BCD files as specified in the following table:
|
||||||||||||||||||
[/Transport] |
Configures settings used by the Transport Server as specified in the following table:
|
Examples
To set the server to answer only known clients, with a response delay of 4 minutes, type:
WDSUTIL /Set-Server /AnswerClients:Known /ResponseDelay:4
To set the boot program and architecture for the server, type:
WDSUTIL /Set-Server /BootProgram:boot\x86\pxeboot.n12 /Architecture:x86
To enable logging on the server, type:
WDSUTIL /Set-Server /WdsClientLogging /Enabled:Yes /LoggingLevel:Warnings
To enable unattend on the server, as well as the architecture and the client unattend file, type:
WDSUTIL /Set-Server /WdsUnattend /Policy:Enabled /File:WDSClientUnattend \unattend.xml /Architecture:x86
To set the Pre-Boot Execution Environment (PXE) server to attempt to bind to TCP ports 67 and 60, type:
WDSUTIL /Set-server /UseDhcpPorts:No /DhcpOption60:Yes