Wpeutil 命令列選項

Windows PE 公用程式 (Wpeutil) 是包含在 Windows PE 中的命令列工具,可讓您在 Windows PE 會話期間執行命令。 例如,您可以將 Windows PE 關機或重新啟動、啟用或停用防火牆、設定語言設定,以及初始化網路。

Wpeutil 語法

Wpeutil {command} [argument]

例如:

Wpeutil Shutdown
Wpeutil Enablefirewall
Wpeutil SetMuiLanguage de-DE

重要

Wpeutil 每個行只能接受一個命令列。

CreatePageFile

建立所指定路徑及大小的分頁檔。 預設路徑 C:\pagefile.sys 預設大小為 64 MB。 至少必須指定一個選項。

重要

如果頁面檔案存在,CreatePageFile 選項必須設定為等於或大於頁面檔案的目前大小,否則命令將會失敗。

CreatePageFile 語法

CreatePageFile [/path=<path>] [/size=<size>]

CreatePageFile 使用方式

Wpeutil CreatePageFile /path=C:\pagefile.sys /size=128
Wpeutil CreatePageFile /path=C:\pagefile.sys

DisableExtendedCharactersForVolume

針對包含目標磁片區路徑的磁片區,停用 DOS 相容檔案名的擴充字元支援 (8.3 格式) 。 此命令僅適用於 NTFS 磁碟區。 目標磁片區上的路徑必須指定磁片區的根目錄。

如果停用,所有以擴充字元建立的檔案都會轉換成簡短檔案名。

DisableExtendedCharactersForVolume 語法

DisableExtendedCharactersForVolume <path_on_target_volume>

DisableExtendedCharactersForVolume 使用量

Wpeutil DisableExtendedCharactersForVolume C:\

DisableFirewall

停用防火牆。

DisableFirewall 使用量

Wpeutil DisableFirewall

EnableExtendedCharactersForVolume

允許 8.3 格式檔案名在磁片區中包含包含目標磁片區路徑的擴充字元。 此命令僅適用於 NTFS 磁碟區。 目標磁片區上的路徑必須指定磁片區的根目錄。

注意

如果您要以預設啟用的擴充字元的語言安裝作業系統,例如 ja-JP 或 ko-KR,或是以未啟用擴充字元的語言使用 Windows PE 複本,例如 en-US,則安裝會導致第一次開機期間發生 Chkdsk 錯誤。 在您安裝到該磁片區之前啟用此選項,將會防止 Chkdsk 命令執行。

EnableExtendedCharactersForVolume 語法

EnableExtendedCharactersForVolume <path_on_target_volume>

EnableExtendedCharactersForVolume 使用量

Wpeutil EnableExtendedCharactersForVolume C:\

EnableFirewall

啟用防火牆。

EnableFirewall 使用方式

Wpeutil EnableFirewall

InitializeNetwork

初始化網路元件及驅動程式,並將電腦名稱設定為隨機選取的值。 此選項 /NoWait 會略過電腦等候取得 IP 位址的時間。 如果您未使用 /NoWait ,Windows PE 會等到取得位址,再完成載入 WinPE 會話。 /NoWait 對於不使用 DHCP 的環境很有説明。

InitializeNetwork 語法

InitializeNetwork [/NoWait]

InitializeNetwork 使用方式

Wpeutil InitializeNetwork
wpeutil InitializeNetwork /NoWait

ListKeyboardLayouts

列出指定之地區設定識別碼 (LCID) 值的支援鍵盤配置 (名稱及識別碼)。 鍵盤配置也會在登錄的機碼下更新: HKEY_LOCAL_MACHINE \SOFTWARE\Microsoft\Windows NT\CurrentVersion\WinPE\KeyboardLayouts

如需有效地區設定識別碼的清單,請參閱 Microsoft 地區設定識別碼值

ListKeyboardLayouts 語法

ListKeyboardLayouts <LCID>

ListKeyboardLayouts 使用方式

Wpeutil ListKeyboardLayouts 0x0409
Wpeutil ListKeyboardLayouts 1033

重新啟動

重新啟動目前的 Windows PE 工作階段。

重新開機使用方式

Wpeutil Reboot

SaveProfile

停止記錄,並將自訂設定檔儲存至稍早使用 Dism /enable-profiling 命令指定之使用者的位置。 如需 /enable-profiling 命令列選項的詳細資訊,請參閱 DISM Windows PE 服務 Command-Line 選項

SaveProfile 語法

Wpeutil SaveProfile <profile_file_name> "<description>"

SaveProfile 使用方式

Wpeutil SaveProfile profile_file_name "short description"

SetKeyboardLayout

設定目前 Windows PE 工作階段的鍵盤配置。 這會在命令成功之後對進程生效。

SetKeyboardLayout 語法

SetKeyboardLayout <keyboard_layout_ID>

SetKeyboardLayout 使用方式

取得支援的鍵盤配置清單:

ListKeyboardLayouts LCID

若要設定 en-US 的鍵盤:

Wpeutil SetKeyboardLayout 0409:00000409

SetMuiLanguage

設定語言。 <language-name> 使用國際語言代碼格式 (例如,美國英文) 的 en-US。 您可以依優先順序指定多種語言,並使用分號加以隔開。

SetMuiLanguage 語法

SetMuiLanguage <language-name>[;<language-name>]

SetMuiLanguage 使用量

Wpeutil SetMuiLanguage de-DE;en-US

SetUserLocale

設定使用者地區設定。 <language-name> 使用國際語言代碼格式 (例如,美國英文) 的 en-US。 您可以依優先順序指定多種語言,並使用分號加以隔開。

SetUserLocale 語法

SetUserLocale <language-name>[;<language-name>]

SetUserLocale 使用量

Wpeutil SetUserLocale de-DE;en-US

Shutdown

關閉目前的 Windows PE 工作階段。

您也可以在 [命令提示字元] 視窗中執行下列動作:

  • 按一下 [關閉] 按鈕
  • 輸入 EXIT 並按 Enter 鍵

關機使用方式

Wpeutil Shutdown

UpdateBootInfo

在登錄中填入 Windows PE 開機方式的相關資訊。

執行此命令之後,請使用 查詢登錄 wpeutil UpdateBootInfo reg query HKLM\System\CurrentControlSet\Control /v PEBootType

此操作的結果可能會在載入其他驅動程式支援後變更。

若要判斷 Windows PE 的開機位置,請檢查下列各項:

  • PEBootType:Error、Flat、Remote、Ramdisk:SourceIdentified Ramdisk:SourceUnidentified、Ramdisk:OpticalDrive
  • PEBootTypeErrorCode:HRESULT 程式碼
  • PEBootServerName:Windows 部署服務伺服器名稱
  • PEBootServerAddr:Windows 部署服務伺服器 IP 位址
  • PEBootRamdiskSourceDrive:如果有的話,來源磁碟機號。
  • PEFirmwareType:韌體開機模式:BIOS 0x1,0x2 UEFI。

如果您未開機 Windows 部署服務,判斷 Windows PE 開機來源的最佳方式是先檢查 PEBootRamdiskSourceDrive 登錄機碼。 如果不存在,請掃描正確 PEBootType 的磁片磁碟機,並尋找識別開機磁片磁碟機的某種標記檔案。

UpdateBootInfo 使用方式

Wpeutil UpdateBootInfo

WaitForNetwork

等候網路卡初始化。 建立腳本時,請使用此命令,以確保網路卡已在繼續之前完全初始化。

WaitForNetwork 使用方式

Wpeutil WaitForNetwork

WaitForRemovableStorage

在 Windows PE 啟動順序期間,此命令會封鎖啟動,直到 USB 硬碟等卸載式存放裝置初始化為止。

WaitForRemovableStorage 使用量

Wpeutil WaitForRemovableStorage

WinPE 概觀

WinPE:掛接和自訂

DISM Windows PE 服務 Command-Line 選項