共用方式為

Windows 安裝程式命令行選項

  • 發行項

下列命令行選項適用於 Windows 安裝程式（setup.exe）。 從 Windows 10 版本 1607 開始，您可以使用安裝程式設定檔作為將參數傳遞至命令行上 Windows 安裝程式的替代方案。 如需詳細資訊，請參閱 Windows 安裝程式自動化概觀。

/1394Debug

在 Windows 執行期間以及在 Windows 安裝程式的 WindowsPE 組態傳遞期間，啟用透過 IEEE 1394 （FireWire） 埠進行核心偵錯。

語法
/1394Debug：<channel> [BaudRate：<baudrate]>


範例

setup /1394debug:1 /baudrate:115200


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 No
setupconfig.ini用於功能更新的 檔案No


備註
>通道的<預設值為 1。 <baudrate> 會指定 Windows 在偵錯期間傳輸數據時要使用的包。 默認值為 19200，但也可以設定為 57600 或 115200。

/AddBootMgrLast

指示 Windows 安裝程式將 Windows 開機管理員新增為 UEFI 韌體開機順序中的最後一個專案。

語法
/AddBootMgrLast


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 和更新版本開始No
setupconfig.ini用於功能更新的 檔案No


備註
只有在執行 Windows PE 4.0 或更新版本的 UEFI 計算機上才支援此選項。

/自動

執行自動升級至較新版本的 Windows。


語法
/Auto {Clean |DataOnly |Upgrade}


參數

參數 描述
乾淨執行 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


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案No


備註
使用 /Auto 時，無法使用自動檔案。 使用 /Auto 時，Windows 安裝程式會取用 ei.cfg，並在開始安裝之前檢查相容性問題。 如果 ei.cfg 格式不正確，Windows 安裝程式會以無訊息方式結束，並記錄結束代碼。 請參閱 下方的 Windows 安裝程序結束代碼。 使用 /Auto 時，僅支援下列 Windows 映射自定義。 這不是 Windows 安裝程式支援原則的變更，而是澄清：

  • 套用累積 （品質） 更新
  • 將更新套用至完成功能更新所需的服務堆疊（如需詳細資訊，請參閱 維護堆疊更新 ）
  • 將更新套用至Setup.exe二進位檔或其他安裝程式用於功能更新的檔案
  • 用於 Windows 復原環境的「安全作業系統」（SafeOS） 的 Appling 更新
  • 新增或移除語言
  • 新增或移除功能隨選安裝

為了清楚起見，使用 /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}


參數

參數 描述
AlwaysSuspendBitLocker 一律會在升級期間暫停。
TryKeepActive嘗試升級而不暫停 BitLocker。 如果升級失敗，Windows 安裝程式將會暫停 BitLocker 並完成升級。 如果未 指定 /BitLocker 選項，這是預設行為。
ForceKeepActive在不暫停 BitLocker 的情況下啟用升級。 如果因為 BitLocker 作用中而無法完成升級，升級將會失敗。


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes

/BusParams

指定 1394、USB 或 NET 偵錯埠的 PCI 位址。

語法
/BusParams：<bus.device.function>


範例

setup /busparams:0.29.7


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 No
setupconfig.ini用於功能更新的 檔案No


備註
總線、裝置和函式編號必須是十進位格式。 如需詳細資訊，請參閱 使用USB 2.0設定核心偵錯。

/ConfigFile

指定 setupconfig 檔案的位置。

語法
/ConfigFile：<location>


參數

參數 描述
<位置>包含 Windows 安裝程式組態檔之資料夾的本機檔案路徑或 UNC 網路路徑。


範例

setup /ConfigFile:\\server\share\


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案No


備註
如果您在命令行中包含選項，並在 setupconfig 檔案中包含相同的選項，則 setupconfig 檔案選項和值具有優先順序。 從 Windows 11 版本 24H2 開始的 WinPE 支援。

/CompactOS

指定是否要使用 Compact OS 功能來節省硬碟空間。

語法
/CompactOS {Enable |Disable}


參數

參數 描述
啟用Windows 安裝程式會使用壓縮的系統檔案安裝 Windows。
停用Windows 安裝程式會使用未壓縮的系統檔案安裝 Windows。


範例

setup /compactos enable


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes


備註
根據預設，Windows 安裝程式會決定是否要自動使用此功能。 若要深入瞭解 Compact OS，請參閱 壓縮 OS、單一實例和映像優化。 從 Windows 11 版本 24H2 開始的 WinPE 支援。

/Compat

指示 Windows 安裝程式如何處理相容性掃描和訊息。

語法
/Compat {IgnoreWarning |ScanOnly}


參數

參數 描述
IgnoreWarningWindows 安裝程式會完成安裝，忽略任何不允許的相容性訊息。
ScanOnlyWindows 安裝程式會透過相容性掃描執行，然後使用結束代碼結束（未完成安裝），以指出是否有任何相容性考慮。 如果找不到任何疑慮，Windows 安裝程式將會傳回0xC1900210。 如果找到相容性考慮，Windows 安裝程式會傳回0xC1900208。


範例

setup /compat ignorewarning


此命令適用於其他參數。 若要在背景中執行 Windows 安裝程式，而不需任何 UI：

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


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
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 <位置>


參數

參數 描述
<位置>本機檔案路徑或 UNC 網路路徑。


範例

setup /copylogs \\server\share\


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes


備註
接受的參數是本機檔案路徑和 UNC 網路路徑。 執行會在系統內容中執行，因此它可能沒有複製到需要用戶許可權的位置的許可權。 從 Windows 11 版本 24H2 開始的 WinPE 支援。

Debug/

在 Windows 執行時，以及在 Windows 安裝程式的 WindowsPE 組態階段期間，啟用透過通訊 （COM） 埠進行核心偵錯。

語法
/Debug：<port> [BaudRate：<baudrate>]


參數

參數 描述
<port>指定偵錯埠。 預設值是 1秒。
<baudrate>指定在偵錯期間 Windows 傳輸資料時要使用的包。 默認設定為 19200，但也可以設定為 57600 或 115200。


範例

setup /debug:1 /baudrate:115200


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 No
setupconfig.ini用於功能更新的 檔案No

/DiagnosticPrompt

指定在 Windows 安裝程式期間可以使用命令提示字元。

語法
/DiagnosticPrompt {Enable |Disable}


參數

參數 描述
啟用您可以在 Windows 安裝程式期間按 Shift+F10 來存取命令提示字元。
停用Windows 安裝程式期間無法使用命令提示字元。 在離線和 OOBE 階段執行時，命令提示字元無法使用。 這是預設設定。


範例

setup /diagnosticprompt enable


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes


備註
此選項可從 Windows 10 版本 1703 開始提供。 從 Windows 11 版本 24H2 開始的 WinPE 支援。

/DynamicUpdate

指定 Windows 安裝程式是否會執行動態更新作業（搜尋、下載及安裝更新）。

語法
/DynamicUpdate {Enable |停用 |NoDrivers |NoLCU |NoDriversNoLCU}


參數

參數 描述
啟用動態更新作業會執行。
停用不會執行動態更新作業。
NoDrivers除了驅動程式擷取之外，會執行動態更新作業。
NoDriversNoLCU除了驅動程式和最新的累積更新擷取之外，會執行動態更新作業。
NoLCU動態更新作業會執行，但最新的累積更新擷取除外。


範例

setup /auto upgrade /dynamicupdate disable


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案適用於以 Microsoft 更新 （MU） 為基礎的功能更新;只有在指定 /DynamicUpdate NoDrivers 時，才能針對整合更新平臺 （UUP） 型功能更新


備註
NoDrivers、 NoLCU 和 NoDriversNoLCU 是 Windows 10 版本 2004 的新功能。 指定 NoDrivers、NoLCU 或 NoDriversNoLCU 時，將會執行動態更新作業，但不會執行驅動程式和/或最新的累積更新擷取。 /DynamicUpdate 可與 /SkipFinalize 搭配使用，以控制動態更新作業; 搭配 /Finalize 使用時，會忽略 /DynamicUpdate。

/EMSPort

啟用或停用 Windows 安裝程式期間和安裝伺服器作業系統之後的緊急管理服務 （EMS）。

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


參數

參數 描述
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


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 No
setupconfig.ini用於功能更新的 檔案No

/EULA

指示 Windows 安裝程式隱藏 Windows 安裝程式終端使用者許可協定用戶體驗。

語法
/EULA 接受


範例

setup /auto upgrade /quiet /eula accept


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes


備註
此選項是從 Windows 11 開始的新功能。 指定 /EULA 接受 會指示 Windows 安裝程式已接受使用者許可協定。 從 Windows 11 開始，開始安裝 Windows 安裝程式之前，必須先接受 Windows EULA。 藉由指定 /EULA， 您同意在套用此操作系統時，透過大量授權購買適用的 Windows 授權，或 （2） 接受相關Microsoft軟體授權條款。 如果未指定 /EULA 且已指定 /Quiet，則 Windows 安裝程式會傳回錯誤MOSETUP_E_EULA_ACCEPT_REQUIRED （0xC190010E），如果不支援用戶互動，則 Windows 安裝程式會傳回錯誤 （2）。 若要深入了解授權，請參閱 Microsoft授權條款。

/完成

指示 Windows 安裝程式在舊版作業系統上完成先前啟動的更新作業，然後立即重新啟動以啟動離線階段。

語法
/完成


範例

setup /auto upgrade /finalize


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案No


備註
此選項是 Windows 10 版本 2004 的新功能。 /Finalize 不應該以 /NoReboot 選項指定。 如果呼叫 /Finalize，且裝置在執行 /SkipFinalize 之後未處於正常狀態，Windows 安裝程式會傳回錯誤MOSETUP_E_FINALIZE_RESUME_FAILURE （0xC1900132）。 請參閱 /SkipFinalize。

/ImageIndex

指示如果可能適用多個映像，請指示 Windows 安裝程式要從 install.wim 安裝的作業系統映射。

語法
/ImageIndex <索引>


範例

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


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案適用於以 Microsoft 更新 （MU） 為基礎的功能更新;統一更新平臺 （UUP） 型功能更新否


備註
如果適用多個映像，Windows 安裝程式將會提示用戶選取。 如果適用多個映像，且使用 /Quiet 叫用 Windows 安裝程式，Windows 安裝程式將會失敗，錯誤MOSETUP_E_NO_MATCHING_INSTALL_IMAGE （0xC1900215）。 當使用 /PKey 指定的產品密鑰套用至多個 OS 映射時，可能會發生這種情況。

/InstallDrivers

將 .inf 樣式驅動程式新增至新的 Windows 10 安裝。

語法
/InstallDrivers <位置>


參數

參數 描述
<位置>包含 .inf 檔案之資料夾的本機檔案路徑或 UNC 網路路徑。


範例

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


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes


備註
此選項是從 Windows 10 開始的新選項。 驅動程式 .inf 可以位於指定位置內的資料夾中。 此命令會透過指定的位置遞歸。 從 Windows 11 版本 24H2 開始的 WinPE 支援。

/InstallFrom

指定 Windows 安裝程式期間要使用的不同 Install.wim 檔案。

語法
/InstallFrom<路徑>


參數

參數 描述:
<path>要安裝的 .wim 檔案路徑。


範例

setup /installfrom D:\custom.wim

此選項也會與分割映像檔 （.swm） 搭配使用。 選取數列中的第一個分割映像檔

setup /installfrom D:\install.swm


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案No


備註
這可讓您使用單一預安裝環境來安裝多個版本的 Windows 映像。 例如，您可以使用 32 位版本的 Windows 安裝程式來部署 64 位 Windows 映射。 您也可以使用回應檔案進行跨平臺部署。 如需詳細資訊，請參閱 Windows 安裝程式支援的平臺和跨平臺部署中的<建立多個架構類型的 WIM>。

/InstallLangPacks

將語言套件 （lp.cab） 新增至新的 Windows 10 或更新版本安裝。

語法
/InstallLangPacks <位置>


參數

參數 描述
<位置>包含.cab檔案之資料夾的本機檔案路徑或 UNC 網路路徑。


範例

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


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案適用於以 Microsoft 更新 （MU） 為基礎的功能更新;統一更新平臺 （UUP） 型功能更新否


備註
此選項是從 Windows 10 開始的新選項。 語言套件可以位於指定 <位置>內的資料夾中。 命令會在指定 <位置>的資料夾和子資料夾中安裝所有lp.cab檔案和語言功能，例如文字到語音辨識。 語言功能可能相依於其他語言功能。 例如，文字到語音轉換取決於相同語言的基本元件。 語言功能不應在位置>內<重新命名。 請參閱隨選語言和區域功能（FOD）。 在 Windows 10 版本 1903 和更新版本中，安裝失敗會導致 Windows 安裝程式失敗並復原。

/m

指示 Windows 安裝程式從替代位置複製替代檔案。 此選項會指示 Windows 安裝程式先查看替代位置，如果檔案存在，請使用它們，而不是預設位置中的檔案。

語法
/m：<folder_name>


參數

參數 描述
<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

如果您變更取代檔案中的資源，您必須將更新的 Multilanguage 使用者介面 （MUI） 檔案新增至安裝。


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 No
setupconfig.ini用於功能更新的 檔案No


備註
您必須知道檔案將在 Windows 安裝上安裝的位置。 所有額外的檔案都必須複製到安裝來源或folder_name>的 <$OEM$ 資料夾。 $OEM$ 結構提供目的地安裝磁碟的表示法：

  • $OEM$\$1 對應至 %SYSTEMDRIVE%，可能是 C 磁碟驅動器。
  • $OEM$\$$ 對應至 %WINDIR%，可能是 C：\windows。
  • $OEM$\$progs對應至程序檔目錄。
  • $OEM$\$docs對應至使用者的 [我的文檔] 資料夾。

/MigNEO

告知 Windows 安裝程式執行 Windows 升級，而不需要額外的離線階段優化。

語法
/MigNEO Disable


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 是僅搭配 /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


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes


備註
您可以指定 [全部 ] 或 [無]。 根據預設，Windows 安裝程式會根據安裝選擇，決定最適合每個個別驅動程式。 您可以使用此參數搭配 /InstallDrivers，但並非必要。

/NetDebug

透過網路啟用核心偵錯。

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


參數

參數 描述
<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


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 No
setupconfig.ini用於功能更新的 檔案No


備註
使用 hostip 來識別主電腦的 IP 位址。 使用 埠 來識別埠。 默認啟動埠為 49152，預設結束埠為 65535。 使用 金鑰 來提供密碼來設定安全連線。 使用 nodhcp 避免使用 DHCP 連線。 （選擇性）。 使用 busparams 來選取特定 PCI 總線裝置之適配卡的總線號碼、裝置號碼和函式編號。 （選擇性）。 如需其他詳細數據，請參閱 手動透過網路纜線設定內核模式偵錯。

/NoReboot

指示 Windows 安裝程式在 Windows 安裝程式的下層階段完成之後，不要重新啟動電腦。

語法
/NoReboot


範例

setup /noreboot


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案No


備註
此選項是 Windows 10 的新功能。 /NoReboot 選項可讓您在 Windows 重新啟動之前執行其他命令。 此選項只會抑制第一次重新啟動。 此選項不會抑制後續重新啟動。 從 Windows 11 版本 24H2 開始的 WinPE 支援。

/PKey

提供具有特定產品密鑰的 Windows 安裝程式。

語法
/PKey <產品金鑰>


範例

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


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes


備註
此選項是從 Windows 10 開始的新選項。 從 Windows 11 版本 24H2 開始的 WinPE 支援。

/優先權

告知 Windows 安裝程式透過 Windows Update 將功能更新的線程優先順序從低到正常。

語法
/Priority {Normal |Low}


參數

參數 描述
NormalWindows 安裝程式會以一般線程優先順序執行。
低Windows 安裝程式會以低線程優先順序執行。


範例

setup.exe /auto upgrade /skipfinalize /priority low


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes


備註
此選項從 Windows 10 版本 1709 和更新版本開始提供。 Windows 10 版本 2004 的低 優先順序是新的。 媒體型安裝預設已以 正常 優先順序執行，但可減少為 低 優先順序。

/PostOOBE

Windows 安裝程式完成之後，請執行腳本。

語法
/PostOOBE<位置> [\setupcomplete.cmd]


參數

參數 描述
<位置>本機檔案路徑或名為 setupcomplete.cmd 檔案的 UNC 網路路徑或包含setupcomplete.cmd的資料夾。


範例

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


包含名稱為setupcomplete.cmd之腳本的資料夾路徑。 setupcomplete.cmd會複製到 $Windows.~BT，以在 OOBE 之後執行。

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


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes


備註
此選項可從 Windows 10 開始使用。 從 Windows 11 版本 24H2 開始的 WinPE 支援。

/PostRollback

指示 Windows 安裝程式執行文本，如果功能更新無法安裝並回復變更，或使用者選擇卸載功能更新並返回舊版 Windows，請執行腳本。

語法
/PostRollback <位置> [/PostRollbackContext {system | user}]


參數

參數 描述
<位置>本機檔案路徑或名為 setuprollback.cmd 之檔案的 UNC 網路路徑，或包含setuprollback.cmd的資料夾。


範例

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


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes


備註
此選項可從 Windows 10 開始使用。 /PostRollbackContext 選項適用於 Windows 10 版本 1803 和更新版本。 /PostRollbackContext 選項可讓您指定腳本是在系統帳戶的內容或已登入使用者的帳戶中執行。 根據預設，來自媒體的更新會在用戶內容中執行setuprollback.cmd，這需要第一個登入升級后的使用者具有系統管理員許可權。 對於 Windows Update 的更新，不論第一個登入使用者的許可權為何，setuprollback.cmd都會在系統內容中執行。 Windows 安裝程式會將setuprollback.cmd複製到 $Windows。~BT 將在 OOBE 之後執行。

/安靜

這會隱藏任何 Windows 安裝程式用戶體驗，包括復原用戶體驗。

語法
/安靜


範例

setup /auto upgrade /quiet


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案No


備註
此選項可從 Windows 10 開始使用。

/ReflectDrivers

指定包含已啟用第三方加密之計算機加密驅動程式的資料夾路徑。

語法
/ReflectDrivers <位置>


參數

參數 描述
<位置>包含 .inf 檔案之資料夾的本機檔案路徑或 UNC 網路路徑。


範例

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


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes


備註
此選項從 Windows 10 版本 1607 開始提供。 請確定 <位置> 只包含一組最少的加密驅動程式。 擁有比必要更多的驅動程式可能會對升級案例造成負面影響。 從 Windows 11 版本 24H2 開始的 WinPE 支援。

/ResizeRecoveryPartition

指定調整現有 Windows 復原環境 （Windows RE） 磁碟分區的大小，或在安裝期間建立新的磁碟分區是否正常。

語法
/ResizeRecoveryPartition {Enable |Disable}


參數

>
參數 描述
啟用在安裝期間，Windows 可以調整現有的 Windows RE 工具磁碟分區大小，或視需要建立新的磁碟分區。
停用Windows 不會調整現有 Windows RE 工具磁碟分區的大小，也不會在安裝期間建立新的磁碟分區。


範例

setup /resizerecoverypartition disable


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes


備註
若要深入瞭解 Windows RE 磁碟分區，請參閱 UEFI/GPT 型硬碟磁碟分區 和 BIOS/MBR 型硬碟磁碟分區。

/ShowOOBE

指定使用者是否需要以互動方式完成現成體驗 （OOBE）。

語法
/ShowOOBE {Full |None}


參數

參數 描述
完整要求用戶以互動方式完成現成體驗 （OOBE）。
None略過 OOBE 並選取預設設定。


範例

setup.exe /auto upgrade /showoobe full


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes


備註
此選項可從 Windows 10 開始使用。

/SkipFinalize

指示設定在下層 OS 上啟動更新作業，而不需起始重新啟動以啟動離線階段。

語法
/SkipFinalize


範例

setup /auto upgrade /quiet /priority low /skipfinalize


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案No


備註
此選項從 Windows 10 版本 2004 開始提供。 /SkipFinalize 會在不認可的情況下準備更新。 這可讓認可使用 /Finalize 完成，然後立即重新啟動裝置。 這是擱置更新的慣用方法，因為 /NoReboot 選項會認可變更，但隱藏第一次重新啟動以允許其他工作。 /SkipFinalize 不會在計算機使用時，自動指示 Windows 安裝程式以無訊息方式在下層 OS 上執行。 使用 /Quiet 來隱藏 Windows 安裝程式用戶體驗，以及 /Priority Low 以防止用戶影響。 /SkipFinalize 不會叫用重新啟動，因此 不需要 /NoReboot 選項。 請參閱 /Finalize。

/遙測

指定 Windows 安裝程式是否應該擷取和報告安裝數據。

語法
/Telemetry {Enable |Disable}


參數

參數 描述
啟用Windows 安裝程式會擷取並報告安裝數據。
停用Windows 安裝程式不會擷取和報告安裝數據。


範例

setup /telemetry disable


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes

/TempDrive

指示 Windows 安裝程式將暫存安裝檔案放在指定的磁碟分區上。

語法
/TempDrive <drive_letter>


參數

參數 描述
<drive_letter>在 Windows 安裝程式期間將安裝檔案複製到其中的分割區。


範例

setup /tempdrive H


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes


備註
此選項從 Windows 10 版本 1607 開始提供。 針對升級， /TempDrive 選項只會影響暫存盤的位置。 操作系統會在您執行setup.exe檔案的分割區中升級。

/Unattend

可讓您搭配 Windows 安裝程式使用回應檔案。

語法
/Unattend：<answer_file>


參數

參數 描述
<answer_file>自動 Windows 安裝程式回應檔案的檔案路徑和檔名。


範例

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


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 No
setupconfig.ini用於功能更新的 檔案No


備註
這稱為自動安裝。 您必須指定answer_file>的值<。 Windows 安裝程式會在安裝期間套用響應檔案中的值。 使用 /Unattend 時，無法使用 /Auto。

/Uninstall

判斷 Windows 是否會包含可讓使用者返回先前操作系統的控制件。

語法
/Uninstall {Enable |Disable}


參數

參數 描述
啟用Windows 安裝程式包含可讓使用者返回先前操作系統的控制件。
停用Windows 安裝程式不包含允許使用者返回先前作業系統的控制件。


範例

setup /uninstall disable


適用性

組態 適用於
Setup.exe從 WinPE 開始No
Setup.exe從 Windows 10 或更新版本開始 Yes
setupconfig.ini用於功能更新的 檔案Yes


備註
此選項可從 Windows 10 開始使用。

/USBDebug

在USB埠上設定偵錯。

語法
/USBDebug：<hostname>


參數

參數 描述
<hostname>要偵錯的計算機名稱。


範例

setup /usbdebug:testmachine01


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 No
setupconfig.ini用於功能更新的 檔案No


備註
偵錯數據會在下次重新啟動時生效。

/WDSDiscover

指定 Windows 部署服務 （WDS） 客戶端應該處於探索模式。

語法
/WDSDiscover


範例
若要以動態探索模式啟動 WDS 用戶端，請執行下列命令：

setup /wds /wdsdiscover


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 No
setupconfig.ini用於功能更新的 檔案No


備註
從 Windows 11 版本 21H2 開始，將無法再使用此選項。 如果您未指定 /WDSServer WDS 搜尋伺服器。

/WDSServer

指定客戶端應該連線的 Windows 部署服務 （WDS） 伺服器名稱。

語法
/WDSServer：<servername>


參數

參數 描述
<servername>Windows 部署服務伺服器的名稱。


範例
若要以靜態探索模式啟動 Windows 部署服務用戶端，請執行下列命令：

setup /wds /wdsdiscover /wdsserver:MyWDSServer


適用性

組態 適用於
Setup.exe從 WinPE 開始Yes
Setup.exe從 Windows 10 或更新版本開始 No
setupconfig.ini用於功能更新的 檔案No


備註
從 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安裝選項（僅限升級或數據）無法使用。


Windows 安裝程序狀態

Windows Setup Edition 組態和產品標識符檔案 （EI.cfg 和 PID.txt）

Windows 安裝程式記錄檔和事件記錄檔