Windows セットアップコマンドラインオプション

[アーティクル]
10/01/2024

Windows セットアップ (setup.exe) には、次のコマンドラインオプションが用意されています。 Windows 10 バージョン 1607 以降では、コマンドラインで Windows セットアップにパラメーターを渡す代わりに、setupconfig ファイルを使用することができます。詳しくは、「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> には、デバッグ中のデータ転送時に使用するボーを指定します。既定値は 19200 ですが、57600 または 115200 に設定することもできます。

/AddBootMgrLast

Windows セットアップに対し、UEFI ファームウェアのブート順の最後のエントリとして Windows ブートマネージャーを追加するように指示します。

構文
/AddBootMgrLast

適用性

構成	適用可能
WinPE から起動された Setup.exe	はい
Windows 10 以上から起動された Setup.exe	いいえ
機能の更新に使用されている setupconfig.ini ファイル	いいえ

注釈
このオプションは、Windows PE 4.0 以降を実行している UEFI PC でのみサポートされます。

/Auto

新しいバージョンの Windows への自動アップグレードを実行します。

構文
/Auto {Clean | DataOnly | Upgrade}

パラメーター

パラメーター	説明
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 を使用した場合、無人セットアップファイルは使用できません。 /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 オプションを使用して新しいイメージをエクスポートするためのソースイメージとして使用できます。このエクスポートされたイメージが Windows セットアップで install.wim の代わりに使用されるようにするには、イメージの名前を install.esd とする必要があります。また、\sources から install.wim を削除する必要があります。 install.esd へとエクスポートするのは、Windows イメージのサイズを小さくしたい場合だけにしてください。エクスポートされたイメージはサイズが小さくなりますが、マウントはできません。

Windows 11 以降では、/Auto によってエンドユーザーライセンス条項の同意や非表示が処理されることはありません。「/EULA」を参照してください。

/BitLocker

アップグレード中の BitLocker の状態を指定します。

構文
/BitLocker {AlwaysSuspend | TryKeepActive | ForceKeepActive}

パラメーター

パラメーター	説明
AlwaysSuspend	アップグレード中、BitLocker は常に中断されます。
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 ファイル	いいえ

注釈
bus、device、function の番号は 10 進形式である必要があります。詳しくは、「USB 2.0 を使用したカーネルデバッグの設定」をご覧ください。

/ConfigFile

setupconfig ファイルの場所を指定します。

構文
/ConfigFile:<location>

パラメーター

パラメーター	説明
<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}

パラメーター

パラメーター	説明
有効にする	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}

パラメーター

パラメーター	説明
IgnoreWarning	Windows セットアップは、無視できる互換性に関するメッセージをすべて無視してインストールを完了します。
ScanOnly	Windows セットアップは、互換性スキャンを実行し、互換性の問題があるかどうかを示す終了コードを返して (インストールを完了せずに) 終了します。問題が見つからなかった場合、Windows セットアップは 0xC1900210 を返します。互換性の問題が見つかった場合、Windows セットアップは 0xC1900208 を返します。

IgnoreWarning

Windows セットアップは、無視できる互換性に関するメッセージをすべて無視してインストールを完了します。

ScanOnly

Windows セットアップは、互換性スキャンを実行し、互換性の問題があるかどうかを示す終了コードを返して (インストールを完了せずに) 終了します。問題が見つからなかった場合、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 を確認します。 Windows セットアップのログを収集するには、/CopyLogs を使用します。

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>

パラメーター

パラメーター	説明
<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>]

パラメーター

パラメーター	説明
<port>	デバッグするポートを指定します。既定値は 1 です。
<baudrate>	デバッグ中のデータ転送時に使用するボーを指定します。既定の設定は 19200 ですが、57600 または 115200 に設定することもできます。

使用例

setup /debug:1 /baudrate:115200

適用性

構成	適用可能
WinPE から起動された Setup.exe	はい
Windows 10 以上から起動された Setup.exe	いいえ
機能の更新に使用されている setupconfig.ini ファイル	いいえ

/DiagnosticPrompt

Windows セットアップの実行時にコマンドプロンプトが使用可能になることを指定します。

構文
/DiagnosticPrompt {Enable | Disable}

パラメーター

パラメーター	説明
有効にする	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}

パラメーター

パラメーター	説明
有効にする	動的更新操作が実行されます。
無効にする	動的更新操作は実行されません。
NoDrivers	動的更新操作は、ドライバーの取得を除いて実行されます。
NoDriversNoLCU	動的更新操作は、ドライバーと最新の累積的な更新プログラムの取得を除き、実行されます。
NoLCU	動的更新操作は、最新の累積的な更新プログラムの取得を除き、実行されます。

使用例

setup /auto upgrade /dynamicupdate disable

適用性

構成	適用可能
WinPE から起動された Setup.exe	いいえ
Windows 10 以上から起動された Setup.exe	はい
機能の更新に使用されている setupconfig.ini ファイル	Microsoft Update (MU) ベースの機能更新の場合は適用可能。Unified Updated Platform (UUP) ベースの機能更新の場合は、/DynamicUpdate NoDrivers が指定されている場合に限り、適用可能

注釈
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 で、Serial Port Console Redirection (SPCR) テーブルの値が使用されます。 BIOS に SPCR テーブルと EFI コンソールデバイスパスのどちらも指定されていない場合は、Windows で EMS が無効になります。
"オフ"	EMS を無効にします。 Windows セットアップで EMS を無効にした場合、後でブート設定を変更して EMS を有効にできます。
<baudrate>	デバッグ中のデータ転送時に使用するボーを指定します。既定値は 19200 ですが、57600 または 115200 に設定することもできます。

使用例

setup /emsport:COM1 /emsbaudrate:115200

適用性

構成	適用可能
WinPE から起動された Setup.exe	はい
Windows 10 以上から起動された Setup.exe	いいえ
機能の更新に使用されている setupconfig.ini ファイル	いいえ

/EULA

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

ダウンレベルの OS で以前に開始された更新操作を完了した後、直ちに再起動してオフラインフェーズを開始するように、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

複数のイメージが適用可能な場合に、install.wim からどの OS イメージをインストールするかを Windows セットアップに指示します。

構文
/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 Update (MU) ベースの機能更新の場合は適用可能。Unified Updated Platform (UUP) ベースの機能更新の場合は適用不可

注釈
複数のイメージが適用可能な場合、Windows セットアップによってユーザーに選択を求めるメッセージが表示されます。複数のイメージが適用可能な場合で、Windows セットアップが /Quiet を使用して呼び出された場合、Windows セットアップはエラー MOSETUP_E_NO_MATCHING_INSTALL_IMAGE (0xC1900215) により失敗します。これは、/PKey を使用して指定されたプロダクトキーが複数の OS イメージに適用される場合に発生する可能性があります。

/InstallDrivers

新しい Windows 10 インストールに .inf スタイルのドライバーを追加します。

構文
/InstallDrivers <location>

パラメーター

パラメーター	説明
<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>

パラメーター

パラメーター	Description
<path>	インストールする .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

新しい Windows 10 またはそれ以降のインストールに言語パック (lp.cab) を追加します。

構文
/InstallLangPacks <location>

パラメーター

パラメーター	説明
<location>	.cab ファイルを含むフォルダーへのローカルファイルパスまたは UNC ネットワークパス。

使用例

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

適用性

構成	適用可能
WinPE から起動された Setup.exe	いいえ
Windows 10 以上から起動された Setup.exe	はい
機能の更新に使用されている setupconfig.ini ファイル	Microsoft Update (MU) ベースの機能更新の場合は適用可能。Unified Updated Platform (UUP) ベースの機能更新の場合は適用不可

注釈
このオプションは Windows 10 以降の新機能です。言語パックは、指定された <location> 内のフォルダーに格納できます。コマンドを実行すると、指定した <location> にあるフォルダーとサブフォルダーに、すべての lp.cab ファイルと言語機能 (テキスト読み上げなど) がインストールされます。言語機能は、他の言語機能に依存している場合があります。たとえば、テキスト読み上げは、同じ言語の基本コンポーネントに依存します。 <location> 内で言語機能の名前を変更することはしないでください。「言語と地域のオンデマンド機能 (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

置換ファイル内でリソースを変更する場合は、更新した多言語ユーザーインターフェイス (MUI) ファイルをインストールに追加する必要があります。

適用性

構成	適用可能
WinPE から起動された Setup.exe	はい
Windows 10 以上から起動された Setup.exe	いいえ
機能の更新に使用されている setupconfig.ini ファイル	いいえ

注釈
Windows インストールでファイルがインストールされる場所を把握しておく必要があります。追加のファイルは、いずれも、インストール元の $OEM$ フォルダーか、<folder_name> に指定したフォルダーにコピーする必要があります。 $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 は、Non-event Objective (非イベント目標) を意味する略語です。これは、機能更新のオフライン時間を減らすための、複数リリースでの取り組みです (ほとんどのユーザーに対して再起動を 1 回にするなど)。このオプションは、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>]

パラメーター

パラメーター	説明
<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 ファイル	いいえ

注釈
ホストコンピューターの IP アドレスを識別するには、hostip を使用します。ポートを識別するには、port を使用します。既定の開始ポートは 49152、既定の終了ポートは 65535 です。セキュリティで保護された接続を設定するためのパスワードを指定するには、key を使用します。 DHCP 接続の使用を回避するには、nodhcp を使用します。 (オプション)。特定の PCI バスデバイスのアダプターのバス番号、デバイス番号、および機能番号を選択するには、busparams を使用します。 (オプション)。詳しくは、「ネットワークケーブル経由でカーネルモードデバッグを手動設定する」をご覧ください。

/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 Update を通じた機能更新について、スレッド優先度を低から通常に上げるよう Windows セットアップに指示します。

構文
/Priority {Normal | Low}

パラメーター

パラメーター	説明
Normal	Windows セットアップは、通常のスレッド優先度で実行されます。
低	Windows セットアップは、低いスレッド優先度で実行されます。

使用例

setup.exe /auto upgrade /skipfinalize /priority low

適用性

構成	適用可能
WinPE から起動された Setup.exe	いいえ
Windows 10 以上から起動された Setup.exe	はい
機能の更新に使用されている setupconfig.ini ファイル	はい

注釈
このオプションは、Windows 10 バージョン 1709 以降で使用できます。 Low の優先度は、Windows 10 バージョン 2004 の新機能です。メディアベースのインストールは、既定では常に Normal の優先度で実行されますが、Low 優先度に減らすこともできます。

/PostOOBE

Windows セットアップの完了後にスクリプトを実行します。

構文
/PostOOBE<location> [\setupcomplete.cmd]

パラメーター

パラメーター	説明
<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}]

パラメーター

パラメーター	説明
<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 Update からの更新プログラムの場合、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>

パラメーター

パラメーター	説明
<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}

パラメーター

パラメーター	説明
有効にする	インストール中に、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

ユーザーが Out of Box Experience (OOBE) を対話的に完了する必要があるかどうかを指定します。

構文
/ShowOOBE {Full | None}

パラメーター

パラメーター	説明
完全	ユーザーは、Out of Box Experience (OOBE) を対話的に完了する必要があります。
なし	OOBE をスキップし、既定の設定を選択します。

使用例

setup.exe /auto upgrade /showoobe full

適用性

構成	適用可能
WinPE から起動された Setup.exe	いいえ
Windows 10 以上から起動された Setup.exe	はい
機能の更新に使用されている setupconfig.ini ファイル	はい

注釈
このオプションは、Windows 10 以降で使用できます。

/SkipFinalize

再起動してオフラインフェーズを開始することなく、ダウンレベルの OS で更新操作を開始するよう設定します。

構文
/SkipFinalize

使用例

setup /auto upgrade /quiet /priority low /skipfinalize

適用性

構成	適用可能
WinPE から起動された Setup.exe	いいえ
Windows 10 以上から起動された Setup.exe	はい
機能の更新に使用されている setupconfig.ini ファイル	いいえ

注釈
このオプションは、Windows 10 バージョン 2004 以降で使用できます。 /SkipFinalize を指定すると、更新はコミットなしで準備されます。これにより、/Finalize を使用してコミットを完了した後、デバイスをすぐに再起動することができます。更新を保留する場合には、このオプションを使用することをお勧めします。/NoReboot オプションの場合、変更はコミットされますが、追加のタスクを許可するために最初の再起動が抑制されます。 /SkipFinalize では、コンピューターの使用中にダウンレベルの OS でサイレントに実行するように Windows セットアップに自動的に指示することはありません。 Windows セットアップのユーザーエクスペリエンスを非表示にするには /Quiet を使用し、ユーザーへの影響を防止するには /Priority Low を使用してください。 /SkipFinalize では再起動は呼び出されないため、/NoReboot オプションは必要ありません。「/Finalize」を参照してください。

/Telemetry

Windows セットアップでインストールデータをキャプチャしてレポートするかどうかを指定します。

構文
/Telemetry {Enable | Disable}

パラメーター

パラメーター	説明
有効にする	Windows セットアップでインストールデータをキャプチャし、レポートします。
無効にする	Windows セットアップで、インストールデータをキャプチャしてレポートすることはしません。

使用例

setup /telemetry disable

適用性

構成	適用可能
WinPE から起動された Setup.exe	いいえ
Windows 10 以上から起動された Setup.exe	はい
機能の更新に使用されている setupconfig.ini ファイル	はい

/TempDrive

指定したパーティションに一時インストールファイルを格納するように Windows セットアップに指示します。

構文
/TempDrive <drive_letter>

パラメーター

パラメーター	説明
<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>

パラメーター

パラメーター	説明
<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}

パラメーター

パラメーター	説明
有効にする	ユーザーが前のオペレーティングシステムに戻れるようにするためのコントロールを、Windows セットアップに含めます。
無効にする	ユーザーが前のオペレーティングシステムに戻れるようにするためのコントロールを、Windows セットアップに含めません。

使用例

setup /uninstall disable

適用性

構成	適用可能
WinPE から起動された Setup.exe	いいえ
Windows 10 以上から起動された Setup.exe	はい
機能の更新に使用されている setupconfig.ini ファイル	はい

注釈
このオプションは、Windows 10 以降で使用できます。

/USBDebug

USB ポートでデバッグを設定します。

構文
/USBDebug:<hostname>

パラメーター

パラメーター	説明
<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>

パラメーター

パラメーター	説明
<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_REBOOT	0x3	このアップグレードは成功しました。
CONX_SETUP_EXITCODE_RESUME_AT_COMPAT_REPORT	0x5	互換性チェックで、アップグレードを続行する前に解決する必要がある問題が検出されました。
CONX_SETUP_EXITCODE_AUTO_INSTALL_FAIL	0x7	インストールオプション (アップグレードまたはデータのみ) を使用できませんでした。

Windows セットアップの状態

Windows セットアップのエディション構成と製品 ID のファイル (EI.cfg および PID.txt)

Windows セットアップのログファイルとイベントログ

次の方法で共有

Windows セットアップ コマンド ライン オプション

/1394Debug

/AddBootMgrLast

/Auto

/BitLocker

/BusParams

/ConfigFile

/CompactOS

/Compat

/CopyLogs

/Debug

/DiagnosticPrompt

/DynamicUpdate

/EMSPort

/EULA

/Finalize

/ImageIndex

/InstallDrivers

/InstallFrom

/InstallLangPacks

/m

/MigNEO

/MigrateDrivers

/NetDebug

/NoReboot

/PKey

/Priority

/PostOOBE

/PostRollback

/Quiet

/ReflectDrivers

/ResizeRecoveryPartition

/ShowOOBE

/SkipFinalize

/Telemetry

/TempDrive

/Unattend

/Uninstall

/USBDebug

/WDSDiscover

/WDSServer

Windows セットアップの終了コード

関連トピック

その他のリソース

Windows セットアップコマンドラインオプション