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 兆字节。 必须至少指定一个选项。
重要
如果存在页文件,则必须将 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)安装操作系统,并且使用未启用扩展字符语言(如 en-US)的 Windows PE 副本,则安装时将在第一次启动期间引发 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
列出给定区域设置 ID(LCID)值支持的键盘布局(名称和 ID)。 还会在注册表中的 HKEY_LOCAL_MACHINE \SOFTWARE\Microsoft\Windows NT\CurrentVersion\WinPE\KeyboardLayouts
项下更新键盘布局。
有关有效区域设置 ID 的列表,请参阅 Microsoft 区域设置 ID 值。
ListKeyboardLayouts 语法
ListKeyboardLayouts <LCID>
ListKeyboardLayouts 用法
Wpeutil ListKeyboardLayouts 0x0409
Wpeutil ListKeyboardLayouts 1033
重新启动
重启当前的 Windows PE 会话。
Reboot 用法
Wpeutil Reboot
SaveProfile
停止日志记录,并将自定义配置文件保存到用户之前使用 Dism /enable-profiling 命令指定的位置。 有关 /enable-profiling 命令行选项的详细信息,请参阅 DISM Windows PE 服务命令行选项。
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
关机
关闭当前的 Windows PE 会话。
你还可以在命令提示符窗口中执行以下操作:
- 单击“关闭”按钮
- 键入
EXIT
,然后按 Enter
Shutdown 用法
Wpeutil Shutdown
UpdateBootInfo
使用有关 Windows PE 启动方式的信息填充注册表。
运行此命令后,使用 wpeutil UpdateBootInfo reg query HKLM\System\CurrentControlSet\Control /v PEBootType
查询注册表
加载其他驱动程序支持后,此操作的结果可能会更改。
若要确定 Windows PE 的启动位置,请检查以下内容:
- PEBootType:Flat、Remote、Ramdisk:SourceIdentified、Ramdisk:SourceUnidentified、Ramdisk:OpticalDrive
- PEBootTypeErrorCode:HRESULT 代码
- PEBootServerName:Windows 部署服务服务器名称
- PEBootServerAddr:Windows 部署服务服务器 IP 地址
- PEBootRamdiskSourceDrive:源驱动器号(如果有)。
- PEFirmwareType:固件启动模式:针对 BIOS 为 0x1,针对 UEFI 为 0x2。
如果未启动 Windows 部署服务,确定 Windows PE 启动位置的最佳方式是首先检查 PEBootRamdiskSourceDrive 注册表项。 如果它不存在,请扫描正确 PEBootType 的驱动器,并查找某种标识启动驱动器的标记文件。
UpdateBootInfo 用法
Wpeutil UpdateBootInfo
WaitForNetwork
等待网卡初始化。 在创建脚本时使用此命令,以确保在继续操作之前已完全初始化网卡。
WaitForNetwork 用法
Wpeutil WaitForNetwork
WaitForRemovableStorage
在 Windows PE 启动顺序中,此命令将在初始化可移动存储设备(例如 USB 硬盘驱动器)之前阻止启动。
WaitForRemovableStorage 用法
Wpeutil WaitForRemovableStorage