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 表示除非按下 Esc 鍵，否則用戶端會執行 PXE 開機。 |
| [/BootProgram:<Relative path>] /Architecture:{x86 | ia64 | x64} | 指定 remoteInstall 資料夾中開機程式的相對路徑 (例如：boot\x86\pxeboot.n12)，並指定開機程式的架構。 |
| [/N12BootProgram:<Relative path>] /Architecture:{x86 | ia64 | x64} | 指定不需要按下 F12 鍵的開機程式相對路徑 (例如：boot\x86\pxeboot.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 中尚未預先設置的電腦加入網域。 預設設定為 Yes。 |
| [/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