Windows 설치 프로그램 명령줄 옵션

아티클
10/18/2023

Windows 설치 프로그램(setup.exe)에는 다음 명령줄 옵션을 사용할 수 있습니다. Windows 10 버전 1607부터 명령줄에서 Windows 설치 프로그램에 매개 변수를 전달하는 대신 setupconfig 파일을 사용할 수 있습니다. 자세한 내용은 Windows 설치 프로그램 자동화 개요를 참조하세요.

/1394Debug

Windows가 실행 중이고 Windows 설치 프로그램의 WindowsPE 구성 단계 중에 IEEE 1394(FireWire) 포트를 통한 커널 디버깅을 사용하도록 설정합니다.

Syntax
/1394Debug:<channel> [BaudRate:<baudrate>]

예제

setup /1394debug:1 /baudrate:115200

적용

구성	적용
WinPE에서 시작된 Setup.exe	예
Windows 10 이상에서 시작된 Setup.exe	아니요
기능 업데이트에 사용되는 setupconfig.ini 파일	아니요

설명
<채널>의 기본값은 1입니다. <baudrate>는 디버깅 중에 Windows가 데이터를 전송할 때 사용할 전송 속도를 지정합니다. 기본값은 19200이지만 57600 또는 115200으로 설정할 수도 있습니다.

/AddBootMgrLast

UEFI 펌웨어 부팅 순서의 마지막 항목으로 Windows 부팅 관리자를 추가하도록 Windows 설치 프로그램에 지시합니다.

Syntax
/AddBootMgrLast

적용

구성	적용
WinPE에서 시작된 Setup.exe	예
Windows 10 이상에서 시작된 Setup.exe	아니요
기능 업데이트에 사용되는 setupconfig.ini 파일	아니요

설명
이 옵션은 Windows PE 4.0 이상을 실행하는 UEFI PC에서만 지원됩니다.

/Auto

최신 버전의 Windows로 자동 업그레이드를 수행합니다.

Syntax
/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

적용

구성	적용
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도 제거해야 합니다. Windows 이미지 크기를 줄이려면 install.esd로만 내보내야 합니다. 내보낸 이미지는 더 작아지지만 탑재할 수 없습니다.

Windows 11부터 /Auto는 최종 사용자 라이선스 계약을 수락하거나 억제하지 않습니다. /EULA를 참조하세요.

/BitLocker

업그레이드 중 BitLocker 상태를 지정합니다.

Syntax
/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 주소를 지정합니다.

Syntax
/BusParams:<bus.device.function>

예제

setup /busparams:0.29.7

적용

구성	적용
WinPE에서 시작된 Setup.exe	예
Windows 10 이상에서 시작된 Setup.exe	아니요
기능 업데이트에 사용되는 setupconfig.ini 파일	아니요

설명
버스, 디바이스 및 기능 번호는 10진수 형식이어야 합니다. 자세한 내용은 USB 2.0으로 커널 디버깅 설정을 참조하세요.

/ConfigFile

setupconfig 파일의 위치를 지정합니다.

Syntax
/ConfigFile:<location>

매개 변수

매개 변수	설명
<location>	Windows 설치 프로그램 구성 파일이 포함된 폴더에 대한 로컬 파일 경로 또는 UNC 네트워크 경로입니다.

예제

setup /ConfigFile:\\server\share\

적용

구성	적용
WinPE에서 시작된 Setup.exe	아니요
Windows 10 이상에서 시작된 Setup.exe	예
기능 업데이트에 사용되는 setupconfig.ini 파일	아니요

설명
명령줄에 옵션을 포함하고 setupconfig 파일에 동일한 옵션을 포함하는 경우 setupconfig 파일 옵션 및 값이 우선합니다.

/CompactOS

컴팩트 OS 기능을 사용하여 하드 드라이브 공간을 절약할지 여부를 지정합니다.

Syntax
/CompactOS {Enable | Disable}

매개 변수

매개 변수	설명
사용	Windows 설치 프로그램은 압축된 시스템 파일을 사용하여 Windows를 설치합니다.
사용 안 함	Windows 설치 프로그램은 압축되지 않은 시스템 파일을 사용하여 Windows를 설치합니다.

예제

setup /compactos enable

적용

구성	적용
WinPE에서 시작된 Setup.exe	아니요
Windows 10 이상에서 시작된 Setup.exe	예
기능 업데이트에 사용되는 setupconfig.ini 파일	예

설명
기본적으로 Windows 설치 프로그램은 이 기능을 자동으로 사용할지 여부를 결정합니다. 컴팩트 OS에 대한 자세한 내용은 컴팩트 OS, 단일 인스턴스 및 이미지 최적화를 참조하세요.

/Compat

Windows 설치 프로그램에 호환성 검사 및 메시지를 처리하는 방법을 지시합니다.

Syntax
/Compat {IgnoreWarning | ScanOnly}

매개 변수

매개 변수	설명
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을 확인하는 경우가 많습니다. /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 설치 프로그램은 컴퓨터/사용자가 해당 위치에 대한 권한과 네트워크 액세스 권한을 가지고 있다고 가정하고 실패 시 압축된 로그를 복사하거나 업로드합니다.

Syntax
/CopyLogs <location>

매개 변수

매개 변수	설명
<location>	로컬 파일 경로 또는 UNC 네트워크 경로입니다.

예제

setup /copylogs \\server\share\

적용

구성	적용
WinPE에서 시작된 Setup.exe	아니요
Windows 10 이상에서 시작된 Setup.exe	예
기능 업데이트에 사용되는 setupconfig.ini 파일	예

설명
허용되는 매개 변수는 로컬 파일 경로와 UNC 네트워크 경로입니다. 실행은 시스템 컨텍스트에서 실행되므로 사용자 권한이 필요한 위치에 복사할 권한이 없을 수 있습니다.

/Debug

Windows가 실행 중일 때와 Windows 설치 프로그램의 WindowsPE 구성 단계에서 통신(COM) 포트를 통한 커널 디버깅을 사용하도록 설정합니다.

Syntax
/Debug:<port> [BaudRate:<baudrate>]

매개 변수

매개 변수	설명
<port>	디버깅 포트를 지정합니다. 기본값은 1입니다.
<baudrate>	Windows가 디버깅 중에 데이터를 전송할 때 사용할 전송 속도를 지정합니다. 기본 설정은 19200이지만 57600 또는 115200으로 설정할 수도 있습니다.

예제

setup /debug:1 /baudrate:115200

적용

구성	적용
WinPE에서 시작된 Setup.exe	예
Windows 10 이상에서 시작된 Setup.exe	아니요
기능 업데이트에 사용되는 setupconfig.ini 파일	아니요

/DiagnosticPrompt

Windows 설치 프로그램 중에 명령 프롬프트를 사용할 수 있도록 지정합니다.

Syntax
/DiagnosticPrompt {Enable | Disable}

매개 변수

매개 변수	설명
사용	명령 프롬프트는 Windows 설치 프로그램 중에 Shift+F10을 눌러 액세스할 수 있습니다.
사용 안 함	Windows 설치 프로그램 중에는 명령 프롬프트를 사용할 수 없습니다. 명령 프롬프트는 오프라인 및 OOBE 단계가 실행 중인 동안 사용할 수 없습니다. 이것이 기본 설정입니다.

예제

setup /diagnosticprompt enable

적용

구성	적용
WinPE에서 시작된 Setup.exe	아니요
Windows 10 이상에서 시작된 Setup.exe	예
기능 업데이트에 사용되는 setupconfig.ini 파일	예

설명
이 옵션은 Windows 10, 버전 1703부터 사용할 수 있습니다.

/DynamicUpdate

Windows 설치 프로그램이 동적 업데이트 작업(업데이트 검색, 다운로드 및 설치)을 수행할지 여부를 지정합니다.

Syntax
/DynamicUpdate {Enable | Disable | NoDrivers | NoLCU | NoDriversNoLCU}

매개 변수

매개 변수	설명
사용	동적 업데이트 작업이 수행됩니다.
사용 안 함	동적 업데이트 작업은 수행되지 않습니다.
NoDrivers	드라이버 획득을 제외하고 동적 업데이트 작업이 수행됩니다.
NoDriversNoLCU	드라이버 및 최신 누적 업데이트 획득을 제외하고 동적 업데이트 작업이 수행됩니다.
NoLCU	최신 누적 업데이트 획득을 제외하고 동적 업데이트 작업이 수행됩니다.

예제

setup /auto upgrade /dynamicupdate disable

적용

구성	적용
WinPE에서 시작된 Setup.exe	아니요
Windows 10 이상에서 시작된 Setup.exe	예
기능 업데이트에 사용되는 setupconfig.ini 파일	MU(Microsoft 업데이트) 기반 기능 업데이트의 경우 예, /DynamicUpdate NoDrivers가 지정된 경우에만 UUP(통합 업데이트 플랫폼) 기반 기능 업데이트의 경우 예

설명
NoDrivers, NoLCU 및 NoDriversNoLCU는 Windows 10 버전 2004의 새로운 기능입니다. NoDrivers, NoLCU 또는 NoDriversNoLCU가 지정되면 동적 업데이트 작업이 수행되지만 드라이버 및/또는 최신 누적 업데이트 획득은 수행되지 않습니다. /DynamicUpdate는 /SkipFinalize와 함께 사용하여 동적 업데이트 작업을 제어할 수 있습니다. /DynamicUpdate는 /Finalize와 함께 사용할 때 무시됩니다.

/EMSPort

Windows 설치 프로그램 중 및 서버 운영 체제가 설치된 후 EMS(응급 관리 서비스)를 사용하거나 사용하지 않도록 설정합니다.

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

매개 변수

매개 변수	설명
COM1	COM1을 통해 EMS를 사용하도록 설정합니다. x86 시스템에서만 지원됩니다.
COM2	COM2를 통해 EMS를 사용하도록 설정합니다. x86 시스템에서만 지원됩니다.
BIOS 설정 사용	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 설치 프로그램 지침입니다.

Syntax
/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 소프트웨어 사용 조건에 동의하는 것으로 간주됩니다. Windows 설치 프로그램은 /EULA accept가 지정되지 않고 (1) /Quiet이 지정되거나 (2) 사용자 상호 작용이 지정된 Windows 설치 프로그램이 시작된 경우 오류 MOSETUP_E_EULA_ACCEPT_REQUIRED(0xC190010E)를 반환합니다. 라이선스에 대한 자세한 내용은 Microsoft 사용 조건을 참조하세요.

/Finalize

Windows 설치 프로그램이 이전에 시작된 업데이트 작업을 하위 수준 OS에서 완료한 다음 즉시 다시 부팅하여 오프라인 단계를 시작하도록 지시합니다.

Syntax
/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 설치 프로그램 지침입니다.

Syntax
/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 파일	MU(Microsoft 업데이트) 기반 기능 업데이트의 경우 예, UUP(통합 업데이트 플랫폼) 기반 기능 업데이트의 경우 아니요

설명
여러 이미지를 적용할 수 있는 경우 Windows 설치 프로그램에서 사용자에게 선택하라는 메시지를 표시합니다. 여러 이미지를 적용할 수 있고 /Quiet을 사용하여 Windows 설치 프로그램을 호출하면 Windows 설치 프로그램이 실패하고 오류 MOSETUP_E_NO_MATCHING_INSTALL_IMAGE(0xC1900215)가 발생합니다. 이는 /PKey를 사용하여 지정된 제품 키가 여러 OS 이미지에 적용될 때 발생할 수 있습니다.

/InstallDrivers

새 Windows 10 설치에 .inf 스타일 드라이버를 추가합니다.

Syntax
/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는 지정된 위치 내의 폴더에 있을 수 있습니다. 명령은 지정된 위치를 통해 반복됩니다.

/InstallFrom

Windows 설치 프로그램 중에 사용할 다른 Install.wim 파일을 지정합니다.

Syntax
/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)을 추가합니다.

Syntax
/InstallLangPacks <location>

매개 변수

매개 변수	설명
<location>	.inf 파일이 포함된 폴더에 대한 로컬 파일 경로 또는 UNC 네트워크 경로입니다.

예제

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

적용

구성	적용
WinPE에서 시작된 Setup.exe	아니요
Windows 10 이상에서 시작된 Setup.exe	예
기능 업데이트에 사용되는 setupconfig.ini 파일	MU(Microsoft 업데이트) 기반 기능 업데이트의 경우 예, UUP(통합 업데이트 플랫폼) 기반 기능 업데이트의 경우 아니요

설명
이 옵션은 Windows 10부터 새로 추가되었습니다. 언어 팩은 지정된 <location> 내의 폴더에 있을 수 있습니다. 이 명령은 지정된 <location>의 폴더 및 하위 폴더에 모든 lp.cab 파일 및 텍스트 음성 변환 인식과 같은 언어 기능을 설치합니다. 언어 기능은 다른 언어 기능에 의존할 수 있습니다. 예를 들어, 텍스트 음성 변환은 동일한 언어의 기본 구성 요소에 종속됩니다. 언어 기능은 <location> 내에서 이름을 바꾸면 안 됩니다. 언어 및 지역 FOD(주문형 기능)를 참조하세요. Windows 10 버전 1903 이상에서 설치 실패로 인해 Windows 설치 프로그램이 실패하고 롤백됩니다.

/m

대체 위치에서 대체 파일을 복사하도록 Windows 설치 프로그램에 지시합니다. 이 옵션은 Windows 설치 프로그램이 대체 위치를 먼저 찾고 파일이 있는 경우 기본 위치의 파일 대신 사용하도록 지시합니다.

Syntax
/m:<folder_name>

매개 변수

매개 변수	설명
<folder_name>	대체 파일이 포함된 폴더의 이름과 위치는 모든 로컬 드라이브 위치일 수 있습니다. UNC 경로는 지원되지 않습니다.

예제
업데이트된 C:\Program Files\Messenger\Msmsgs.exe 파일을 Windows 설치에 복사하려면 설치 명령을 사용하여 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은 C 드라이브일 수 있는 %SYSTEMDRIVE%에 매핑됩니다.
$OEM$\$$는 C:\windows일 수 있는 %WINDIR%에 매핑됩니다.
$OEM$\$progs는 프로그램 파일 디렉터리에 매핑됩니다.
$OEM$\$docs는 사용자의 내 문서 폴더에 매핑됩니다.

/MigNEO

추가 오프라인 단계 최적화 없이 Windows 업그레이드를 수행하도록 Windows 설치 프로그램에 지시합니다.

Syntax
/MigNEO Disable

적용

구성	적용
WinPE에서 시작된 Setup.exe	아니요
Windows 10 이상에서 시작된 Setup.exe	/Auto Upgrade \| DataOnly인 경우에만 예
기능 업데이트에 사용되는 setupconfig.ini 파일	/Auto Upgrade \| DataOnly인 경우에만 예

설명
NEO는 대부분의 사용자를 위한 단일 다시 부팅을 포함하여 기능 업데이트 오프라인 시간을 줄이기 위한 다중 릴리스 노력인 Non-event Objective의 약자입니다. 이 옵션은 Windows 10, 버전 1803 이상부터 사용할 수 있습니다.

/MigrateDrivers

업그레이드하는 동안 기존 설치에서 드라이버를 마이그레이션할지 여부를 Windows 설치 프로그램에 지시합니다.

Syntax
/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

네트워크를 통한 커널 디버깅을 사용하도록 설정합니다.

Syntax
/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 파일	아니요

설명
hostip를 사용하여 호스트 컴퓨터의 IP 주소를 식별합니다. port를 사용하여 포트를 식별합니다. 기본 시작 포트는 49152이고 기본 종료 포트는 65535입니다. key를 사용하여 보안 연결을 설정하기 위한 암호를 제공합니다. DHCP 연결을 사용하지 않으려면 nodhcp를 사용합니다. (선택 사항). busparams를 사용하여 특정 PCI 버스 디바이스용 어댑터의 버스 번호, 디바이스 번호 및 기능 번호를 선택합니다. (선택 사항). 자세한 내용은 네트워크 케이블을 통해 수동으로 커널 모드 디버깅 설정을 참조하세요.

/NoReboot

Windows 설치 프로그램의 하위 단계가 완료된 후 컴퓨터를 다시 시작하지 않도록 Windows 설치 프로그램에 지시합니다.

Syntax
/NoReboot

예제

setup /noreboot

적용

구성	적용
WinPE에서 시작된 Setup.exe	아니요
Windows 10 이상에서 시작된 Setup.exe	예
기능 업데이트에 사용되는 setupconfig.ini 파일	아니요

설명
이 옵션은 Windows 10의 새로운 기능입니다. /NoReboot 옵션을 사용하면 Windows가 다시 시작되기 전에 추가 명령을 실행할 수 있습니다. 이 옵션은 첫 번째 다시 부팅만 억제합니다. 이 옵션은 후속 다시 부팅을 억제하지 않습니다.

/PKey

특정 제품 키와 함께 Windows 설치 프로그램을 제공합니다.

Syntax
/PKey <제품 키>

예제

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

적용

구성	적용
WinPE에서 시작된 Setup.exe	아니요
Windows 10 이상에서 시작된 Setup.exe	예
기능 업데이트에 사용되는 setupconfig.ini 파일	예

설명
이 옵션은 Windows 10부터 새로 추가되었습니다.

/Priority

Windows 업데이트를 통한 기능 업데이트에 대해 스레드 우선 순위를 낮음에서 보통으로 높이도록 Windows 설치 프로그램에 지시합니다.

Syntax
/Priority {Normal | Low}

매개 변수

매개 변수	설명
보통	Windows 설치 프로그램이 일반 스레드 우선 순위로 실행됩니다.
낮음	Windows 설치 프로그램이 낮은 스레드 우선 순위로 실행됩니다.

예제

setup.exe /auto upgrade /skipfinalize /priority low

적용

구성	적용
WinPE에서 시작된 Setup.exe	아니요
Windows 10 이상에서 시작된 Setup.exe	예
기능 업데이트에 사용되는 setupconfig.ini 파일	예

설명
이 옵션은 Windows 10, 버전 1709 이상부터 사용할 수 있습니다. 낮은 우선 순위는 Windows 10 버전 2004의 새로운 기능입니다. 미디어 기반 설치는 기본적으로 이미 Normal 우선 순위로 실행되지만 Low 우선 순위로 낮출 수 있습니다.

/PostOOBE

Windows 설치 프로그램이 완료된 후 스크립트를 실행합니다.

Syntax
/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부터 사용할 수 있습니다.

/PostRollback

기능 업데이트 설치에 실패하고 변경 내용을 롤백하거나 사용자가 기능 업데이트를 제거하고 이전 버전의 Windows로 돌아가도록 선택하는 경우 스크립트를 실행하도록 Windows 설치 프로그램에 지시합니다.

Syntax
/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 업데이트에서 업데이트하는 경우 setuprollback.cmd는 처음 로그인한 사용자의 권한에 관계없이 시스템 컨텍스트에서 실행됩니다. Windows 설치 프로그램은 setuprollback.cmd를 $Windows.~BT로 복사하여 OOBE 후에 실행됩니다.

/Quiet

이렇게 하면 롤백 사용자 환경을 포함한 모든 Windows 설치 프로그램 사용자 환경이 억제됩니다.

Syntax
/Quiet

예제

setup /auto upgrade /quiet

적용

구성	적용
WinPE에서 시작된 Setup.exe	아니요
Windows 10 이상에서 시작된 Setup.exe	예
기능 업데이트에 사용되는 setupconfig.ini 파일	아니요

설명
이 옵션은 Windows 10부터 사용할 수 있습니다.

/ReflectDrivers

타사 암호화가 사용하도록 설정된 컴퓨터의 암호화 드라이버가 포함된 폴더의 경로를 지정합니다.

Syntax
/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>에 최소한의 암호화 드라이버 집합만 포함되어 있는지 확인합니다. 필요 이상으로 많은 드라이버가 있으면 업그레이드 시나리오에 부정적인 영향을 미칠 수 있습니다.

/ResizeRecoveryPartition

기존 Windows RE(Windows 복구 환경) 파티션의 크기를 조정하거나 설치 중에 새 파티션을 만들어도 되는지 여부를 지정합니다.

Syntax
/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

사용자가 OOBE(기본 제공 환경)를 대화형으로 완료해야 하는지 여부를 지정합니다.

Syntax
/ShowOOBE {Full | None}

매개 변수

매개 변수	설명
전체	사용자가 OOBE(기본 제공 환경)를 대화형으로 완료해야 합니다.
없음	OOBE를 건너뛰고 기본 설정을 선택합니다.

예제

setup.exe /auto upgrade /showoobe full

적용

구성	적용
WinPE에서 시작된 Setup.exe	아니요
Windows 10 이상에서 시작된 Setup.exe	예
기능 업데이트에 사용되는 setupconfig.ini 파일	예

설명
이 옵션은 Windows 10부터 사용할 수 있습니다.

/SkipFinalize

오프라인 단계를 시작하기 위해 다시 부팅을 시작하지 않고 하위 수준 OS에서 업데이트 작업을 시작하기 위한 지침 설정입니다.

Syntax
/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 설치 프로그램에 자동으로 지시하지 않습니다. /Quiet를 사용하여 Windows 설치 프로그램 사용자 환경을 억제하고 /Priority Low를 사용하여 사용자에게 미치는 영향을 방지합니다. /SkipFinalize는 다시 부팅을 호출하지 않으므로 /NoReboot 옵션이 필요하지 않습니다. /Finalize를 참조하세요.

/Telemetry

Windows 설치 프로그램이 설치 데이터를 캡처하고 보고해야 하는지 여부를 지정합니다.

Syntax
/Telemetry {Enable | Disable}

매개 변수

매개 변수	설명
사용	Windows 설치 프로그램이 설치 데이터를 캡처하고 보고합니다.
사용 안 함	Windows 설치 프로그램이 설치 데이터를 캡처하고 보고하지 않습니다.

예제

setup /telemetry disable

적용

구성	적용
WinPE에서 시작된 Setup.exe	아니요
Windows 10 이상에서 시작된 Setup.exe	예
기능 업데이트에 사용되는 setupconfig.ini 파일	예

/TempDrive

지정된 파티션에 임시 설치 파일을 저장하도록 Windows 설치 프로그램에 지시합니다.

Syntax
/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 설치 프로그램에서 응답 파일을 사용할 수 있습니다.

Syntax
/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에 포함할지 여부를 결정합니다.

Syntax
/Uninstall {Enable | Disable}

매개 변수

매개 변수	설명
사용	Windows 설치 프로그램에는 사용자가 이전 운영 체제로 돌아갈 수 있는 컨트롤이 포함되어 있습니다.
사용 안 함	Windows 설치 프로그램에는 사용자가 이전 운영 체제로 돌아갈 수 있는 컨트롤이 포함되어 있지 않습니다.

예제

setup /uninstall disable

적용

구성	적용
WinPE에서 시작된 Setup.exe	아니요
Windows 10 이상에서 시작된 Setup.exe	예
기능 업데이트에 사용되는 setupconfig.ini 파일	예

설명
이 옵션은 Windows 10부터 사용할 수 있습니다.

/USBDebug

USB 포트에서 디버깅을 설정합니다.

Syntax
/USBDebug:<hostname>

매개 변수

매개 변수	설명
<hostname>	디버그할 컴퓨터의 이름입니다.

예제

setup /usbdebug:testmachine01

적용

구성	적용
WinPE에서 시작된 Setup.exe	예
Windows 10 이상에서 시작된 Setup.exe	아니요
기능 업데이트에 사용되는 setupconfig.ini 파일	아니요

설명
디버그 데이터는 다음 다시 부팅 시 적용됩니다.

/WDSDiscover

WDS(Windows 배포 서비스) 클라이언트가 검색 모드에 있어야 함을 지정합니다.

Syntax
/WDSDiscover

예제
동적 검색 모드에서 WDS 클라이언트를 시작하려면 다음 명령을 실행합니다.

setup /wds /wdsdiscover

적용

구성	적용
WinPE에서 시작된 Setup.exe	예
Windows 10 이상에서 시작된 Setup.exe	아니요
기능 업데이트에 사용되는 setupconfig.ini 파일	아니요

설명
이 옵션은 Windows 11 버전 21H2부터 더 이상 사용할 수 없습니다. /WDSServer를 지정하지 않으면 WDS가 서버를 검색합니다.

/WDSServer

클라이언트에서 연결할 WDS(Windows 배포 서비스) 서버의 이름을 지정합니다.

Syntax
/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 설치 프로그램 종료 코드

관련 항목

추가 리소스