wdsutil set-server
配置 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