wdsutil set-server
适用范围：Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows Server 2012 R2、Windows Server 2012
配置 Windows 部署服务服务器的设置。
语法
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>]
[/PxepromptPolicy
[/Known:{OptIn | Noprompt | OptOut}]
[/New:{OptIn | Noprompt | OptOut}]
[/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>]
[/ObtainIpv6From:Range]
[/start:<start IP address>]
[/End:<End IP address>]
[/startPort:<start Port>
[/EndPort:<start Port>
[/Profile:{10Mbps | 100Mbps | 1Gbps | Custom}]
[/MulticastSessionPolicy]
[/Policy:{None | AutoDisconnect | Multistream}]
[/Threshold:<Speed in KBps>]
[/StreamCount:{2 | 3}]
[/Fallback:{Yes | No}]
[/forceNative]
参数
| 参数 | 说明 |
|---|---|
| [/Server:<Server name>] | 指定服务器的名称。 可以是 NetBIOS 名称或完全限定域名 (FQDN)。 如果未指定服务器名称，将使用本地服务器。 |
| [/Authorize:{Yes | No}] | 指定是否在动态主机控制协议 (DHCP) 中授权此服务器。 |
| [/RogueDetection:{Yes | No}] | 启用或禁用 DHCP 未授权检测。 |
| [/AnswerClients:{All | Known | None}] | 指定此服务器将应答的客户端。 如果将此值设置为 Known，则必须在 Active Directory 域服务 (AD DS) 中预留计算机，然后 Windows 部署服务服务器才会应答该计算机。 |
| [/Responsedelay:<time in seconds>] | 服务器在应答启动客户端之前等待的时间。 此设置不适用于预留的计算机。 |
| [/AllowN12forNewClients:{Yes | No}] | 对于 Windows Server 2008，指定未知客户端不必按 F12 键即可开始网络启动。 已知客户端将接收为计算机指定的启动程序，如果未指定，则接收为体系结构指定的启动程序。 对于 Windows Server 2008 R2，此选项已替换为以下命令：wdsutil /Set-Server /PxepromptPolicy /New:Noprompt |
| [/ArchitectureDiscovery:{Yes | No}] | 启用或禁用体系结构发现。 这有助于发现未正确广播其体系结构的基于 x64 的客户端。 |
| [/resetBootProgram:{Yes | No}] | 确定是否擦除刚启动而不需要按 F12 键的客户端的启动路径。 |
| [/DefaultX86X64Imagetype: {x86 | x64 | Both}] | 控制将向基于 x64 的客户端显示哪些启动映像。 |
| [/UseDhcpPorts:{Yes | No}] | 指定 PXE 服务器是否应尝试绑定到 DHCP 端口（TCP 端口 67）。 如果 DHCP 和 Windows 部署服务在同一台计算机上运行，则应将此选项设置为 No 以使 DHCP 服务器能够利用端口，并将 /DhcpOption60 参数设置为 Yes。 此值的默认设置为 Yes。 |
| [/DhcpOption60:{Yes | No}] | 指定是否应为 PXE 支持配置 DHCP 选项 60。 如果 DHCP 和 Windows 部署服务在同一服务器上运行，请将此选项设置为 Yes，并将 /UseDhcpPorts 选项设置为 No。 此值的默认设置为 No。 |
| [/RpcPort:<Port number>] | 指定用于为客户端请求提供服务的 TCP 端口号。 |
| [/PxepromptPolicy] | 配置已知（预留）客户端和新客户端开始 PXE 启动的方式。 此选项仅适用于 Windows Server 2008 R2。 可以使用以下选项设置这些设置： - [/Known:{OptIn|OptOut|Noprompt}] - 为预留客户端设置策略。 OptIn 表示客户端需要按一个键才能开始 PXE 启动，否则它将回退到下一个启动设备。 Noprompt 表示客户端将始终执行 PXE 启动。 OptOut 表示客户端将执行 PXE 启动，除非按下 Esc 键。 |
| [/BootProgram:<Relative path>] /Architecture:{x86 | ia64 | x64} | 指定 remoteInstall 文件夹中启动程序的相对路径（例如 bootx86pxeboot.n12），并指定启动程序的体系结构。 |
| [/N12BootProgram:<Relative path>] /Architecture:{x86 | ia64 | x64} | 指定不需要按 F12 键的启动程序的相对路径（例如 bootx86pxeboot.n12），并指定启动程序的体系结构。 |
| [/BootImage:<Relative path>] /Architecture:{x86 | ia64 | x64} | 指定启动客户端应接收的启动映像的相对路径，并指定启动映像的体系结构。 可以为每个体系结构指定此项。 |
| [/PreferredDC:<DC Name>] | 指定 Windows 部署服务应使用的域控制器的名称。 它可以是 NetBIOS 名称或 FQDN。 |
| [/PreferredGC:<GC Name>] | 指定 Windows 部署服务应使用的全局目录服务器的名称。 它可以是 NetBIOS 名称或 FQDN。 |
| [/PrestageUsingMAC:{Yes | No}] | 指定在 AD DS 中创建计算机帐户时，Windows 部署服务是否应使用 MAC 地址而不是 GUID/UUID 来标识计算机。 |
| [/NewMachineNamingPolicy:<Policy>] | 指定为客户端生成计算机名称时要使用的格式。 有关用于 <policy> 的格式的信息，请右键单击 mmc 管理单元中的服务器，单击“属性”，然后查看“目录服务”选项卡。例如，/NewMachineNamingPolicy: %61Username%#。 |
| [/NewMachineOU] | 用于指定 AD DS 中将创建客户端计算机帐户的位置。 可以使用以下选项指定位置。 - [/type: Serverdomain | Userdomain | UserOU | Custom ] 指定位置的类型。 Serverdomain 在 Windows 部署服务服务器所在的同一域中创建帐户。 Userdomain 在执行安装的用户所在的同一域中创建帐户。 UserOU 在执行安装的用户所在的同一组织单位中创建帐户。 Custom 允许指定自定义位置（还必须使用此选项指定 /OU 的值）。 |
| [/DomainSearchOrder:{GCOnly | DCFirst}] | 指定用于在 AD DS（全局目录或域控制器）中搜索计算机帐户的策略。 |
| [/NewMachineDomainJoin:{Yes | No}] | 指定在安装过程中是否应将尚未在 AD DS 中预留的计算机加入域。 默认设置为“是”。 |
| [/WdsClientLogging] | 指定服务器的日志记录级别。 - [/Enabled:{Yes | No}] - 启用或禁用 Windows 部署服务客户端操作的日志记录。 |
| [/WdsUnattend] | 这些设置控制 Windows 部署服务客户端的无人参与安装行为。 可以使用以下选项设置这些设置： - [/Policy:{Enabled | Disabled}] - 指定是否使用无人参与安装。 |
| [/AutoaddPolicy] | 这些设置控制自动添加策略。 可以使用以下选项定义这些设置： - [/Policy: {AdminApproval | Disabled}] - AdminApprove 会将所有未知计算机添加到挂起的队列中，然后管理员可以查看计算机列表，并根据需要批准或拒绝每个请求。 Disabled 表示当未知计算机尝试启动到服务器时不执行其他操作。 |
| [/AutoaddSettings] | 指定要应用于每台计算机的默认设置。 可以使用以下选项定义这些设置： - /Architecture: {x86 | ia64 | x64} - 指定体系结构。 |
| [/BindPolicy] | 配置 PXE 提供程序要侦听的网络接口。 可以使用以下选项定义该策略： - [/Policy: {Include | Exclude}] - 设置接口绑定策略以包括或排除接口列表中的地址。 |
| [/RefreshPeriod: <seconds>] | 指定服务器刷新其设置的频率（以秒为单位）。 |
| [/BannedGuidPolicy] | 可以使用以下选项管理禁止的 GUID 列表： - [/add] /Guid:<GUID> - 向禁止的 GUID 列表添加指定的 GUID。 具有此 GUID 的任何客户端都将改为由其 MAC 地址标识。 |
| [/BcdRefreshPolicy] | 可以使用以下选项配置用于刷新 Bcd 文件的设置： - [/Enabled:{Yes | No}] - 指定 Bcd 刷新策略。 当 /Enabled 设置为 Yes 时，将按指定的时间间隔刷新 Bcd 文件。 |
| [/Transport] | 可以配置以下选项：
|
示例
若要将服务器设置为仅应答已知客户端（响应延迟为 4 分钟），请键入：
wdsutil /Set-Server /AnswerClients:Known /Responsedelay:4
若要设置服务器的启动程序和体系结构，请键入：
wdsutil /Set-Server /BootProgram:boot\x86\pxeboot.n12 /Architecture:x86
若要在服务器上启用日志记录，请键入：
wdsutil /Set-Server /WdsClientLogging /Enabled:Yes /LoggingLevel:Warnings
若要在服务器以及体系结构和客户端无人参与文件上启用无人参与，请键入：
wdsutil /Set-Server /WdsUnattend /Policy:Enabled /File:WDSClientUnattend \unattend.xml /Architecture:x86
若要将预启动执行环境 (PXE) 服务器设置为尝试绑定到 TCP 端口 67 和 60，请键入：
wdsutil /Set-server /UseDhcpPorts:No /DhcpOption60:Yes