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

WinPE 概述

WinPE:装载并自定义

DISM Windows PE 服务命令行选项