通过

Windows 安装程序命令行选项

  • 项目

Windows 安装程序 (setup.exe) 可使用以下命令行选项。 从 Windows 10 版本 1607 开始，可以使用 setupconfig 文件作为在命令行中将参数传递给 Windows 安装程序的替代方法。 有关详细信息，请参阅 Windows 安装自动化概述。

/1394Debug

在 Windows 运行的同时或在 Windows 安装程序的 WindowsPE 配置阶段期间，通过 IEEE 1394 (FireWire) 端口进行内核调试。

语法
/1394Debug:<channel> [BaudRate:<baudrate>]


示例

setup /1394debug:1 /baudrate:115200


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 否
用于功能更新的 setupconfig.ini 文件否


备注
<channel> 的默认值为 1。 <baudrate> 指定 Windows 在调试期间传输数据时使用的波特率。 默认值为 19200，但也可以设置为 57600 或 115200。

/AddBootMgrLast

指示 Windows 安装程序将 Windows 启动管理器添加为 UEFI 固件启动顺序中的最后一个条目。

语法
/AddBootMgrLast


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 和更高版本启动 Setup.exe否
用于功能更新的 setupconfig.ini 文件否


备注
此选项仅在运行 Windows PE 4.0 或更高版本的 UEFI 电脑上受支持。

/Auto

自动升级到更高版本的 Windows。


语法
/Auto {Clean | DataOnly | Upgrade}


Parameters

参数 说明
Clean执行 Windows 的全新安装。
DataOnly执行 Windows 升级，仅保存数据（而不保存应用）。如果由于兼容性检查而导致仅数据安装选项不可用，Windows 安装程序将静默退出并记录退出代码。
升级执行 Windows 升级，保存应用和数据。 如果升级安装选项不可用，或者用户需要解决应用兼容性问题，Windows 安装程序将静默退出并记录退出代码。

从 Windows 11 版本 22H2 开始，指定 Upgrade 选项要求安装媒体与目标设备具有相同的系统默认 UI 语言。 在早期版本的 Windows 中，可以执行一些跨语言部署（例如，en-US 到 en-GB），但不再允许这些类型的升级。
NoAutoEit从 Windows 10 开始，此参数不使用。 在 Windows 8.1 中，如果发现错误，Windows 安装程序不会退出，而是停止安装并停留在 Windows 安装程序屏幕，直到用户解决问题为止。 从此时起的安装是有人参与的安装。
PerformDU从 Windows 10 开始，此参数不使用。 在 Windows 8.1 中，Windows 安装程序会检查 Windows 安装程序的动态更新


示例

setup /auto clean

setup /auto dataonly

setup /auto upgrade


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件否


备注
使用 /Auto 时，无法使用 unattend（无人参与）文件。 使用 /Auto 时，Windows 安装程序将使用 ei.cfg，并在开始安装之前检查兼容性问题。 如果 ei.cfg 格式不当，Windows 安装程序将静默退出并记录退出代码。 请参阅下面的 Windows 安装程序退出代码。 使用 /Auto 时，仅支持 Windows 映像的以下自定义。 这不是更改 Windows 安装程序支持策略，而是予以澄清：

  • 应用累积（质量）更新
  • 对完成功能更新所需的服务堆栈应用更新（有关详细信息，请参阅服务堆栈更新）
  • 对 Setup.exe 二进制文件或安装程序用于功能更新的其他文件应用更新
  • 对用于 Windows 恢复环境的“安全操作系统”(SafeOS) 应用更新
  • 添加或删除语言
  • 添加或删除按需功能

为清楚起见，在使用 /Auto 时，Windows 安装程序不支持对已通过添加/删除/更改应用程序、设置或驱动程序自定义的 Windows 映像进行升级或干净安装。

使用 /Auto 时，Windows 安装程序将使用 \sources\install.wim Windows 映像进行升级。 可以通过 Dism /Export-Image 将此映像用作源映像，以便通过 /Compress:recovery 选项导出新映像。 必须将此导出的映像命名为 install.esd，Windows 安装程序才会使用它而不是 install.wim。 还必须从 \sources 中删除 install.wim。 要减小 Windows 映像大小，应该仅导出到 install.esd。 导出的映像更小，但不可装载。

从 Windows 11 开始，/Auto 既不接受也不抑制最终用户许可协议。 请参阅 /EULA。

/BitLocker

指定升级期间的 BitLocker 状态。

语法
/BitLocker {AlwaysSuspend | TryKeepActive | ForceKeepActive}


Parameters

参数 说明
AlwaysSuspendBitLocker 在升级期间始终处于暂停状态。
TryKeepActive尝试升级且不暂停 BitLocker。 如果升级失败，Windows 安装程序将暂停 BitLocker 并完成升级。 如果未指定 /BitLocker 选项，则这是默认行为。
ForceKeepActive启用升级且不暂停 BitLocker。 如果由于 BitLocker 处于活动状态而无法完成升级，升级将会失败。


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是

/BusParams

指定 1394、USB 或 NET 调试端口的 PCI 地址。

语法
/BusParams:<bus.device.function>


示例

setup /busparams:0.29.7


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 否
用于功能更新的 setupconfig.ini 文件否


备注
总线、设备和功能编号必须采用十进制格式。 有关详细信息，请参阅使用 USB 2.0 设置内核调试。

/ConfigFile

指定 setupconfig 文件的位置。

语法
/ConfigFile:<location>


Parameters

参数 说明
<location>本地文件路径，或包含 Windows 安装程序配置文件的文件夹的 UNC 网络路径。


示例

setup /ConfigFile:\\server\share\


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件否


备注
如果在命令行中包含一个选项并在 setupconfig 文件中包含同一选项，则 setupconfig 文件中的选项和值优先。 从 Windows 11 版本 24H2 开始，WinPE 提供支持。

/CompactOS

指定是否使用精简 OS 功能来节省硬盘空间。

语法
/CompactOS {Enable | Disable}


Parameters

参数 说明
启用Windows 安装程序使用压缩系统文件来安装 Windows。
禁用Windows 安装程序使用非压缩系统文件来安装 Windows。


示例

setup /compactos enable


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是


备注
默认情况下，Windows 安装程序将自动确定是否使用此功能。 要详细了解精简 OS，请参阅精简 OS、单一实例和映像优化。 从 Windows 11 版本 24H2 开始，WinPE 提供支持。

/Compat

指示 Windows 安装程序如何处理兼容性扫描和消息。

语法
/Compat {IgnoreWarning | ScanOnly}


Parameters

参数 说明
IgnoreWarningWindows 安装程序完成安装，并忽略任何可忽略的兼容性消息。
ScanOnlyWindows 安装程序运行整个兼容性扫描，然后退出（不完成安装）并返回一个退出代码用于指示是否存在任何兼容性问题。 如果未发现问题，Windows 安装程序将返回 0xC1900210。 如果发现了兼容性问题，Windows 安装程序将返回 0xC1900208。


示例

setup /compat ignorewarning


此命令可结合其他开关运行。 要在不显示任何 UI 的情况下在后台运行 Windows 安装程序，请使用：

setup /auto upgrade /quiet /compat scanonly


要忽略 UI 中的常见免责声明，例如语言更改，请使用：

setup /auto upgrade /quiet /compat scanonly /compat ignorewarning


如果 Windows 安装程序发现兼容性问题，IT 专业人员往往会查看兼容性 XML。 使用 /CopyLogs 收集 Windows 安装程序日志：

setup /auto upgrade /quiet /compat scanonly /compat ignorewarning /copylogs C:\Temp\Logfiles.log


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是，仅与 /Compat IgnoreWarning 结合使用


备注
此选项从 Windows 10 和更高版本开始可用。

如果使用 /Compat ScanOnly 启动 Windows 安装程序：

  • 如果未发现任何兼容性问题，它将返回 MOSETUP_E_COMPAT_SCANONLY (0xC1900210)
  • 如果发现可处理的兼容性问题（例如“应用”），它将返回 MOSETUP_E_COMPAT_INSTALLREQ_BLOCK (0xC1900208)
  • 如果发现选择的 Mig-Choice 不可用，它将返回 MOSETUP_E_COMPAT_MIGCHOICE_BLOCK (0xC1900204)
  • 如果发现计算机不符合 Windows 10 或更高版本的条件，它将返回 MOSETUP_E_COMPAT_SYSREQ_BLOCK (0xC1900200)
  • 如果发现计算机没有足够的可用空间用于安装，它将返回 MOSETUP_E_INSTALLDISKSPACE_BLOCK (0xC190020E)

/CopyLogs

假设计算机/用户对指定的位置拥有权限和网络访问权限，Windows 安装程序在失败时会将压缩的日志复制或上传到该位置。

语法
/CopyLogs <location>


Parameters

参数 说明
<location>本地文件路径或 UNC 网络路径。


示例

setup /copylogs \\server\share\


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是


备注
接受的参数是本地文件路径和 UNC 网络路径。 执行在系统上下文中运行，因此它可能无权复制到需要用户权限的位置。 从 Windows 11 版本 24H2 开始，WinPE 提供支持。

/Debug

支持在运行 Windows 时以及在 Windows 安装程序的 WindowsPE 配置阶段中通过通信 (COM) 端口进行内核调试。

语法
/Debug:<port> [BaudRate:<baudrate>]


Parameters

参数 说明
<port>指定调试端口。 默认值为 1。
<baudrate>指定 Windows 在调试期间传输数据时使用的波特率。 默认设置为 19200，但也可以设置为 57600 或 115200。


示例

setup /debug:1 /baudrate:115200


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 否
用于功能更新的 setupconfig.ini 文件否

/DiagnosticPrompt

指定在 Windows 安装期间可以使用命令提示符。

语法
/DiagnosticPrompt {Enable | Disable}


Parameters

参数 说明
启用在 Windows 安装期间可以按 Shift+F10 访问命令提示符。
禁用在 Windows 安装期间命令提示符不可用。 在运行脱机和 OOBE 阶段时，命令提示符将不可用。 这是默认设置。


示例

setup /diagnosticprompt enable


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是


备注
此选项从 Windows 10 版本 1703 开始可用。 从 Windows 11 版本 24H2 开始，WinPE 提供支持。

/DynamicUpdate

指定 Windows 安装程序是否执行动态更新操作（搜索、下载和安装更新）。

语法
/DynamicUpdate {Enable | Disable | NoDrivers | NoLCU | NoDriversNoLCU}


Parameters

参数 说明
启用执行动态更新操作。
禁用不执行动态更新操作。
NoDrivers执行动态更新操作，但驱动程序获取操作除外。
NoDriversNoLCU执行动态更新操作，但驱动程序和最新累积更新获取操作除外。
NoLCU执行动态更新操作，但最新累积更新获取操作除外。


示例

setup /auto upgrade /dynamicupdate disable


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件对于基于 Microsoft 更新 (MU) 的功能更新为“是”；仅当指定了 /DynamicUpdate NoDrivers 时，对于基于统一更新平台 (UUP) 的功能更新才为“是”


备注
NoDrivers、NoLCU 和 NoDriversNoLCU 是 Windows 10 版本 2004 的新增功能。 如果指定了 NoDrivers、NoLCU 或 NoDriversNoLCU，将执行动态更新操作，但不会执行驱动程序和/或最新累积更新获取操作。 /DynamicUpdate 可与 /SkipFinalize 结合使用以控制动态更新操作；/DynamicUpdate 在与 /Finalize 结合使用时将被忽略。

/EMSPort

在 Windows 安装过程中和安装服务器操作系统之后启用或禁用紧急管理服务 (EMS)。

语法
/EMSPort: {COM1 | COM2 | UseBIOSSettings | Off} [/EMSBaudRate:<baudrate>]


Parameters

参数 说明
COM1在 COM1 上启用 EMS。 仅在 x86 系统上支持。
COM2在 COM2 上启用 EMS。 仅在 x86 系统上支持。
UseBIOSSettings使用 BIOS 指定的设置。 对于 x86 系统，Windows 将使用串行端口控制台重定向 (SPCR) 表中的值。 如果 BIOS 中未指定 SPCR 表或 EFI 控制台设备路径，Windows 将禁用 EMS。
关闭禁用 EMS。 如果在 Windows 安装过程中禁用 EMS，则可以通过修改启动设置稍后启用 EMS。
<baudrate>指定 Windows 在调试期间传输数据时使用的波特率。 默认值为 19200，但也可以设置为 57600 或 115200。


示例

setup /emsport:COM1 /emsbaudrate:115200


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 否
用于功能更新的 setupconfig.ini 文件否

/EULA

指示 Windows 安装程序抑制 Windows 安装程序最终用户许可协议用户体验。

语法
/EULA accept


示例

setup /auto upgrade /quiet /eula accept


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是


备注
此选项是从 Windows 11 开始引入的新选项。 指定 /EULA accept 会向 Windows 安装程序指明最终用户许可协议已接受。 从 Windows 11 开始，在 Windows 安装程序开始安装之前需要接受 Windows EULA。 指定 /EULA accept 即表示你同意在应用此操作系统时 (1) 已通过批量许可购买了适用的 Windows 许可证，或 (2) 接受相关的 Microsoft 软件许可条款。 如果未指定 /EULA accept 并且 (1) 已指定 /Quiet，或者 (2) 如果在不支持用户交互的情况下启动 Windows 安装程序，则 Windows 安装程序将返回错误 MOSETUP_E_EULA_ACCEPT_REQUIRED (0xC190010E)。 有关许可的详细信息，请参阅 Microsoft 许可条款。

/Finalize

指示 Windows 安装程序在下层操作系统上完成先前启动的更新操作，然后立即重启以开始处理脱机阶段。

语法
/Finalize


示例

setup /auto upgrade /finalize


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件否


备注
此选项是 Windows 10 版本 2004 中引入的新选项。 /Finalize 不应与 /NoReboot 选项一起指定。 如果调用 /Finalize 并且设备在运行 /SkipFinalize 后不处于正确的可恢复状态，Windows 安装程序将返回错误 MOSETUP_E_FINALIZE_RESUME_FAILURE (0xC1900132)。 请参阅 /SkipFinalize。

/ImageIndex

指示 Windows 安装程序要从 install.wim 安装哪个操作系统映像（如果有多个适用的映像）。

语法
/ImageIndex <index>


示例

setup.exe /auto upgrade /quiet /compat ignorewarning /imageindex 2 /pkey xxxxx-xxxxx-xxxxx-xxxxx-xxxxx


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件对于基于 Microsoft 更新 (MU) 的功能更新为“是”；对于基于统一更新平台 (UUP) 的功能更新为“否”


备注
如果有多个适用的映像，Windows 安装程序将提示用户选择。 如果有多个适用的映像并且使用 /Quiet 调用 Windows 安装程序，则 Windows 安装程序将会失败并出现错误 MOSETUP_E_NO_MATCHING_INSTALL_IMAGE (0xC1900215)。 当使用 /PKey 指定的产品密钥适用于多个操作系统映像时，可能会发生这种情况。

/InstallDrivers

将 .inf 样式的驱动程序添加到新的 Windows 10 安装。

语法
/InstallDrivers <location>


Parameters

参数 说明
<location>本地文件路径，或包含 .inf 文件的文件夹的 UNC 网络路径。


示例

setup.exe /auto upgrade /installdrivers C:\Fabrikam\drivers /noreboot


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是


备注
此选项是从 Windows 10 开始引入的新选项。 驱动程序 .inf 可以位于指定位置的文件夹中。 该命令将在指定的位置循环递归。 从 Windows 11 版本 24H2 开始，WinPE 提供支持。

/InstallFrom

指定在 Windows 安装期间使用的另一个 Install.wim 文件。

语法
/InstallFrom<path>


Parameters

参数 说明
<路径>要安装的 .wim 文件的路径。


示例

setup /installfrom D:\custom.wim

此选项也可用于拆分的映像文件 (.swm)。 选择系列中第一个拆分的映像文件

setup /installfrom D:\install.swm


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件否


备注
这使你可以使用一个预安装环境来安装多个版本的 Windows 映像。 例如，可以使用 32 位版本的 Windows 安装程序来部署 64 位 Windows 映像。 也可以使用答案文件来执行跨平台部署。 有关详细信息，请参阅 Windows 安装程序支持的平台和跨平台部署中的“为多种体系结构类型创建 WIM”。

/InstallLangPacks

将语言包 (lp.cab) 添加到新的 Windows 10 或更高版本安装。

语法
/InstallLangPacks <location>


Parameters

参数 说明
<location>本地文件路径，或包含 .cab 文件的文件夹的 UNC 网络路径。


示例

setup /auto upgrade /installlangpacks C:\Fabrikam\Languages\French /noreboot


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件对于基于 Microsoft 更新 (MU) 的功能更新为“是”；对于基于统一更新平台 (UUP) 的功能更新为“否”


备注
此选项是从 Windows 10 开始引入的新选项。 语言包可以位于指定 <location> 的文件夹中。 该命令将在位于指定 <location> 的文件夹和子文件夹中安装所有 lp.cab 文件和语言功能，例如文本转语音识别。 语言功能可能依赖于其他语言功能。 例如，文本转语音依赖于同一语言的基本组件。 不应在 <location> 中重命名语言功能。 请参阅语言和区域按需功能 (FOD)。 在 Windows 10 版本 1903 和更高版本中，安装失败会导致 Windows 安装程序失败并回滚。

/m

指示 Windows 安装程序从备用位置复制备用文件。 此选项指示 Windows 安装程序首先查找备用位置，如果文件存在，则使用这些文件而不是默认位置的文件。

语法
/m:<folder_name>


Parameters

参数 说明
<folder_name>包含替换文件的文件夹的名称和位置，可以是任意本地驱动器位置。 不支持 UNC 路径。


示例
要将更新的 C:\Program Files\Messenger\Msmsgs.exe 文件复制到 Windows 安装中，请使用 Setup 命令在 Pro\Sources$OEM$$Progs\Messenger\Msmsgs.exe 安装源上创建以下文件夹结构：

Pro\sources\setup.exe /m


如果要替换由 Windows 文件保护功能保护的文件，还必须将更新的文件复制到随 Windows 一同安装的本地源。 例如，可将该文件复制到 C:\Windows\i386 文件夹中。 该文件名必须与 Windows 安装程序中使用的文件名相同。 例如，将以下文件和文件夹结构添加到 $OEM$ 目录：Pro\sources$OEM$$$\i386\msmsgs.ex_。 如果使用的文件不在安装共享上，则必须指定文件夹名称。 在此示例中，<folder_name> 是 C:\additional_files，其中 C:\additional_files 是自定义的 $OEM$ 目录。 例如：C:\additional_files$$\i386\msmsgs.ex_。

setup /m:C:\additional_files

如果更改替换文件中的资源，则必须将更新的多语言用户界面 (MUI) 文件添加到安装中。


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 否
用于功能更新的 setupconfig.ini 文件否


备注
必须了解将这些文件安装在 Windows 安装上的位置。 必须将所有其他文件复制到安装源中或 <folder_name> 中的 $OEM$ 文件夹。 $OEM$ 结构提供目标安装磁盘的一种表示形式：

  • $OEM$\$1 映射到 %SYSTEMDRIVE%（可能是驱动器 C）。
  • $OEM$\$$ 映射到 %WINDIR%（可能是 C:\windows）。
  • $OEM$\$progs 映射到 program files 目录。
  • $OEM$\$docs 映射到用户的“我的文档”文件夹。

/MigNEO

指示 Windows 安装程序执行 Windows 升级而不进行额外的脱机阶段优化。

语法
/MigNEO Disable


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 仅当与“/Auto Upgrade | DataOnly”结合使用时才为“是”
用于功能更新的 setupconfig.ini 文件仅当与“/Auto Upgrade | DataOnly”结合使用时才为“是”


备注
NEO 是“非事件目标”的英文缩写，它是一项旨在减少脱机功能更新时间的多重发布功能，大多数用户使用此功能只需重启一次。 此选项从 Windows 10 版本 1803 和更高版本开始可用。

/MigrateDrivers

指示 Windows 安装程序在升级期间是否迁移现有安装中的驱动程序。

语法
/MigrateDrivers {All | None}


示例

setup /auto upgrade /migratedrivers all

setup /auto upgrade /migratedrivers none /installdrivers N:\NewDrivers


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是


备注
可以指定 All 或 None。 默认情况下，Windows 安装程序会根据安装选择来确定哪个值最适合每个驱动程序。 可将此开关与 /InstallDrivers 结合使用，但不是非要如此。

/NetDebug

通过网络启用内核调试。

语法
/NetDebug:hostip=<w.x.y.z>,port=<n>,key=<q.r.s.t>[,nodhcp][,busparams=<n.o.p>]


Parameters

参数 说明
<w.x.y.z>主计算机的 IP 地址。
<n>主计算机的端口。
<q.r.s.t>用于设置安全连接的密码。
<n.o.p>特定 PCI 总线设备的适配器的总线编号、设备编号和功能编号。


示例

setup /netdebug:hostip=10.125.4.86,port=50000,key=0.0.0.0

setup /netdebug:hostip=10.125.4.86,port=50000,key=abcdefg.123.hijklmnop.456,nodhcp

setup /netdebug:hostip=10.1.4.8,port=50000,key=dont.use.previous.keys,busparams=1.5.0


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 否
用于功能更新的 setupconfig.ini 文件否


备注
使用 hostip 标识主计算机的 IP 地址。 使用 port 标识端口。 默认起始端口为 49152，默认结束端口为 65535。 使用 key 提供用于设置安全连接的密码。 使用 nodhcp 可避免使用 DHCP 连接。 （可选）。 使用 busparams 选择特定 PCI 总线设备的适配器的总线编号、设备编号和功能编号。 （可选）。 有关更多详细信息，请参阅通过网线手动设置内核模式调试。

/NoReboot

指示 Windows 安装程序在 Windows 安装程序的下层阶段完成之后不重启计算机。

语法
/NoReboot


示例

setup /noreboot


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件否


备注
此选项是 Windows 10 中引入的新选项。 使用 /NoReboot 选项可以在 Windows 重启之前执行其他命令。 此选项仅抑制首次重启。 此选项不会抑制后续重启。 从 Windows 11 版本 24H2 开始，WinPE 提供支持。

/PKey

为 Windows 安装程序提供特定的产品密钥。

语法
/PKey <product key>


示例

setup.exe /auto upgrade /pkey xxxxx-xxxxx-xxxxx-xxxxx-xxxxx


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是


备注
此选项是从 Windows 10 开始引入的新选项。 从 Windows 11 版本 24H2 开始，WinPE 提供支持。

/Priority

指示 Windows 安装程序对于通过 Windows 更新进行的功能更新，将线程优先级从低提高到正常。

语法
/Priority {Normal | Low}


Parameters

参数 说明
正常Windows 安装程序将以正常线程优先级执行。
低Windows 安装程序将以低线程优先级执行。


示例

setup.exe /auto upgrade /skipfinalize /priority low


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是


备注
此选项从 Windows 10 版本 1709 和更高版本开始可用。 低优先级是 Windows 10 版本 2004 的新功能。 默认情况下，基于媒体的安装已在以“正常”优先级运行，但可以降低至“低”优先级。

/PostOOBE

Windows 安装程序完成后运行脚本。

语法
/PostOOBE<location> [\setupcomplete.cmd]


Parameters

参数 说明
<location>名为 setupcomplete.cmd 的文件或包含 setupcomplete.cmd 的文件夹的本地文件路径或 UNC 网络路径。


示例

setup.exe /auto upgrade /postoobe C:\Fabrikam\setupcomplete.cmd


包含名为 setupcomplete.cmd 的脚本的文件夹的路径。 setupcomplete.cmd 将复制到 $Windows.~BT，以便在 OOBE 之后运行。

setup.exe /auto upgrade /postoobe C:\Fabrikam


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是


备注
此选项从 Windows 10 开始可用。 从 Windows 11 版本 24H2 开始，WinPE 提供支持。

/PostRollback

在功能更新安装失败并回滚更改，或者在用户选择卸载功能更新并返回到前一 Windows 版本的情况下，指示 Windows 安装程序运行一个脚本。

语法
/PostRollback <location> [/PostRollbackContext {system | user}]


Parameters

参数 说明
<location>名为 setuprollback.cmd 的文件或包含 setuprollback.cmd 的文件夹的本地文件路径或 UNC 网络路径。


示例

setup.exe /auto upgrade /postrollback C:\Fabrikam\setuprollback.cmd

setup.exe /postrollback C:\Fabrikam\setuprollback.cmd /postrollbackcontext user

setup.exe /auto upgrade /postrollback \server\share


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是


备注
此选项从 Windows 10 开始可用。 /PostRollbackContext 选项在 Windows 10 版本 1803 和更高版本中可用。 使用 /PostRollbackContext 选项可以指定脚本是在系统帐户的上下文中运行，还是在已登录用户的帐户中运行。 默认情况下，来自媒体的更新在用户上下文中运行 setuprollback.cmd，这要求第一个在升级后登录的用户拥有管理员权限。 对于来自 Windows 更新的更新，setuprollback.cmd 将在系统上下文中运行，无论第一个登录用户的权限如何。 Windows 安装程序会将 setuprollback.cmd 复制到 $Windows.~BT，以便在 OOBE 之后运行。

/Quiet

这会抑制任何 Windows 安装程序用户体验，包括回滚用户体验。

语法
/Quiet


示例

setup /auto upgrade /quiet


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件否


备注
此选项从 Windows 10 开始可用。

/ReflectDrivers

指定文件夹的路径，该文件夹包含启用了第三方加密的计算机的加密驱动程序。

语法
/ReflectDrivers <location>


Parameters

参数 说明
<location>本地文件路径，或包含 .inf 文件的文件夹的 UNC 网络路径。


示例

setup /auto upgrade /quiet /reflectdrivers C:\Fabrikam\drivers


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是


备注
此选项从 Windows 10 版本 1607 开始可用。 确保 <location> 仅包含最少量的一组加密驱动程序。 驱动程序比必要的多可能会对升级方案产生负面影响。 从 Windows 11 版本 24H2 开始，WinPE 提供支持。

/ResizeRecoveryPartition

指定在安装期间是否可以调整现有 Windows 恢复环境 (Windows RE) 分区的大小或创建新分区。

语法
/ResizeRecoveryPartition {Enable | Disable}


Parameters

>
参数 说明
启用在安装期间，Windows 可以调整现有 Windows RE 工具分区的大小，或者在需要时创建新分区。
禁用Windows 不会在安装期间调整现有 Windows RE 工具分区的大小或创建新分区。


示例

setup /resizerecoverypartition disable


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是


备注
要详细了解 Windows RE 分区，请参阅基于 UEFI/GPT 的硬盘分区和基于 BIOS/MBR 的硬盘分区。

/ShowOOBE

指定用户是否需要以交互方式完成开箱即用体验 (OOBE)。

语法
/ShowOOBE {Full | None}


Parameters

参数 说明
完整要求用户以交互方式完成开箱即用体验 (OOBE)。
无跳过 OOBE 并选择默认设置。


示例

setup.exe /auto upgrade /showoobe full


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是


备注
此选项从 Windows 10 开始可用。

/SkipFinalize

指示安装程序在下层操作系统上启动更新操作，但不发起重启以开始处理脱机阶段。

语法
/SkipFinalize


示例

setup /auto upgrade /quiet /priority low /skipfinalize


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件否


备注
此选项从 Windows 10 版本 2004 开始可用。 /SkipFinalize 将准备更新但不提交。 允许使用 /Finalize 完成提交，然后立即重启设备。 这是挂起更新的首选方法，因为 /NoReboot 选项将提交更改，但会抑制首次重启以允许执行其他任务。 /SkipFinalize 在计算机被使用时，不会自动指示 Windows 安装程序在下层操作系统上静默运行。 使用 /Quiet 可抑制 Windows 安装程序用户体验，使用 /Priority Low 可防止影响用户。 /SkipFinalize 不会调用重启，因此不需要 /NoReboot 选项。 请参阅 /Finalize。

/Telemetry

指定 Windows 安装程序是否捕获并报告安装数据。

语法
/Telemetry {Enable | Disable}


Parameters

参数 说明
启用Windows 安装程序捕获并报告安装数据。
禁用Windows 安装程序不捕获并报告安装数据。


示例

setup /telemetry disable


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是

/TempDrive

指示 Windows 安装程序将临时安装文件放到指定的分区上。

语法
/TempDrive <drive_letter>


Parameters

参数 说明
<drive_letter>在 Windows 安装期间要将安装文件复制到的分区。


示例

setup /tempdrive H


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是


备注
此选项从 Windows 10 版本 1607 开始可用。 对于升级，/TempDrive 选项仅影响临时文件的放置。 操作系统将在运行 Setup.exe 文件的分区中进行升级。

/Unattend

用于在 Windows 安装程序中使用应答文件。

语法
/Unattend:<answer_file>


Parameters

参数 说明
<answer_file>无人参与 Windows 安装程序应答文件的文件路径和文件名。


示例

setup /unattend:\\server\share\unattend.xml


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 否
用于功能更新的 setupconfig.ini 文件否


备注
这称为无人参与的安装。 必须指定 <answer_file> 的值。 Windows 安装程序在安装期间将应用应答文件中的值。 使用 /Unattend 时不能使用 /Auto。

/Uninstall

确定 Windows 是否包含允许用户还原到前一操作系统的控制。

语法
/Uninstall {Enable | Disable}


Parameters

参数 说明
启用Windows 安装程序包含允许用户还原到前一操作系统的控制。
禁用Windows 安装程序不包含允许用户还原到前一操作系统的控制。


示例

setup /uninstall disable


适用性

配置 适用
从 WinPE 启动 Setup.exe否
从 Windows 10 或更高版本启动 Setup.exe 是
用于功能更新的 setupconfig.ini 文件是


备注
此选项从 Windows 10 开始可用。

/USBDebug

在 USB 端口上设置调试。

语法
/USBDebug:<hostname>


Parameters

参数 说明
<hostname>要调试的计算机的名称。


示例

setup /usbdebug:testmachine01


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 否
用于功能更新的 setupconfig.ini 文件否


备注
调试数据在下一次重新启动时生效。

/WDSDiscover

指定 Windows 部署服务 (WDS) 客户端应处于发现模式。

语法
/WDSDiscover


示例
要以动态发现模式启动 WDS 客户端，请运行以下命令：

setup /wds /wdsdiscover


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 否
用于功能更新的 setupconfig.ini 文件否


备注
从 Windows 11 版本 21H2 开始，此选项不再可用。 如果不指定 /WDSServer，WDS 将搜索服务器。

/WDSServer

指定客户端应连接到的 Windows 部署服务 (WDS) 服务器的名称。

语法
/WDSServer:<servername>


Parameters

参数 说明
<servername>Windows 部署服务服务器的名称。


示例
要以静态发现模式启动 Windows 部署服务客户端，请运行以下命令：

setup /wds /wdsdiscover /wdsserver:MyWDSServer


适用性

配置 适用
从 WinPE 启动 Setup.exe是
从 Windows 10 或更高版本启动 Setup.exe 否
用于功能更新的 setupconfig.ini 文件否


备注
从 Windows 11 版本 21H2 开始，此选项不再可用。 要使用此设置，还必须使用 /WDSDiscover 选项。 <servername> 可以是 IP 地址、NetBIOS 名称或完全限定的域名 (FQDN)。

Windows 安装程序退出代码

退出代码名称 退出代码值 说明
CONX_SETUP_EXITCODE_CONTINUE_REBOOT0x3此次升级成功。
CONX_SETUP_EXITCODE_RESUME_AT_COMPAT_REPORT0x5兼容性检查检测到了问题，必须先解决这些问题，升级才能继续。
CONX_SETUP_EXITCODE_AUTO_INSTALL_FAIL0x7安装选项（仅限 upgrade 或 data）不可用。


Windows 安装状态

Windows 安装程序版本配置文件和产品 ID 文件（EI.cfg 和 PID.txt）

Windows 安装程序日志文件和事件日志