WinSetup64 v4.0 Command Line 옵션
WinSetup64 v4.0에서는 프로그램을 직접 실행하여 GUI에서 작업하는 기존 방식과 함께 Command Line 옵션을 이용한 설치 작업 연동 기능을 추가하였습니다. Command Line을 이용하면 외부 프로그램이나 자동화 스크립트에서 WinSetup64을 호출하여 이미지 파일, 이미지 Index, 설치 드라이브, 부팅 파티션 등을 지정할 수 있습니다. 또한 /Disk와 /Preset을 함께 사용하면 파티션 작업까지 자동으로 수행한 후 Windows 이미지 설치 단계로 연결할 수 있습니다.
1. /ImageFile
/ImageFile:<경로>설치에 사용할 이미지 파일을 지정합니다.
소스에서는 다음 이미지 형식을 지원하도록 구성되어 있습니다.
ISO
WIM
ESD
SWM
예를 들어 ISO 파일을 지정하면 다음과 같이 사용할 수 있습니다.
WinSetup64.exe /ImageFile:"H:\install.iso"
WIM 파일을 직접 지정하는 경우에는 다음과 같이 사용할 수 있습니다.
WinSetup64.exe /ImageFile:"H:\sources\install.wim"
/ImageFile은 Command Line 설치 연동에서 중심이 되는 옵션으로, 실제 설치 작업을 수행하려면 일반적으로 /Index, /ApplyDrv 등의 옵션과 함께 사용하게 됩니다.
2. /Index
/Index:<번호>WIM 또는 ESD 이미지에서 설치할 Windows 에디션의 Index 번호를 지정합니다.
예를 들어 2번 Index를 설치하려면 다음과 같이 지정합니다.
/Index:2
실제 소스에서는 지정된 Index를 프로그램의 이미지 목록에서 찾아 선택하도록 처리되어 있습니다.
따라서 /ImageFile로 이미지 파일을 지정하고 /Index로 설치할 이미지를 선택하는 구조입니다.
예:
WinSetup64.exe /ImageFile:"install.wim" /Index:23. /Disk
/Disk:<디스크번호>
파티션 작업을 수행할 물리 디스크 번호를 지정합니다.
예:
/Disk:6
v4.0에서는 /Disk가 단순히 설치 대상 디스크를 지정하는 용도가 아니라 파티션 작업 자동화와 연결됩니다.
특히 /Disk와 /Preset을 함께 사용하면 지정한 디스크에 저장된 프리셋 설정을 기반으로 파티션 작업을 먼저 수행합니다.
소스의 실제 처리 순서도 다음과 같이 구성되어 있습니다.
/Disk + /Preset
↓
파티션 작업
↓
디스크/파티션 정보 갱신
↓
Windows 이미지 설치
즉, Command Line 하나로 파티션 구성 후 Windows 설치까지 연결할 수 있는 부분입니다.
4. /Preset
/Preset:<1~6>
저장된 파티션 프리셋을 지정합니다.
WinSetup64에서는 WinSetup.ini의 다음과 같은 구조를 사용합니다.
[Preset_1]
[Preset_2]
[Preset_3]
...
[Preset_6]
예:
/Preset:1
소스에서는 /Preset 값을 1~6 범위로 처리하며, 값을 생략하거나 유효하지 않은 값이 들어오는 경우 기본적으로 Preset_1을 사용하도록 구성되어 있습니다.
따라서 다음과 같이 사용할 수 있습니다.
WinSetup64.exe /Disk:6 /Preset:1
이 명령은 6번 디스크에 Preset_1의 파티션 구성을 적용하는 방식입니다.
[Preset_1]
PartType=GPT
WinSize=Auto
WinLabel=Windows
WinLetter=W
SysSize=200
SysLabel=System
SysLetter=S
MSRCheck=4
MSRSize=16
DataCheck=4
DataSize=
DataLabel=Data
WinRECheck=4
WinRESize=2
WinRELabel=Recovery
WinRELetter=R
디스크 프리셋1 파티션 구성 연동 - 움짤(GIF)
5. /ApplyDrv
/ApplyDrv:<드라이브>
Windows 이미지를 실제로 적용할 대상 드라이브를 지정합니다.
예:
/ApplyDrv:W
또는
/ApplyDrv:W:
소스에서는 입력값을 처리하면서 드라이브 문자 형식을 정리하므로 W와 W: 형태를 모두 사용할 수 있도록 구성되어 있습니다.
예:
WinSetup64.exe /ImageFile:"install.wim" /Index:1 /ApplyDrv:W
이 경우 선택한 이미지가 W: 드라이브에 적용됩니다.
6. /BootDrv
/BootDrv:<문자 | - | *>
Windows 설치 후 부팅 파일을 구성할 부팅 파티션을 지정합니다.
이 옵션은 세 가지 방식으로 사용할 수 있습니다.
일반적인 드라이브 문자
/BootDrv:S:
지정한 S: 드라이브를 부팅 파티션으로 사용합니다.
- 자동 검색
/BootDrv:-
설치 대상과 동일한 디스크에서 ESP 또는 Active 부팅 파티션을 자동으로 검색합니다.
특히 /ApplyDrv와 함께 사용하면 설치 대상 드라이브가 속한 디스크를 기준으로 부팅 파티션을 찾아 연결합니다.
따라서 자동 설치 환경에서는 다음과 같이 구성할 수 있습니다.
/ApplyDrv:W /BootDrv:-* 현재 부팅 드라이브
/BootDrv:*
현재 시스템의 부팅 드라이브를 찾아 해당 파티션을 사용합니다.
즉 /BootDrv는 다음 세 가지 방식을 제공합니다.
/BootDrv:S: 지정된 부팅 파티션
/BootDrv:- 설치 디스크에서 자동 검색
/BootDrv:* 현재 시스템 부팅 드라이브7. /OemPath
/OemPath:<경로>
Windows 설치 과정에 사용할 $OEM$ 폴더의 경로를 지정합니다.
예:
/OemPath:"H:\sources\$OEM$"
Command Line으로 $OEM$ 경로를 지정하면 GUI의 $OEM$ 관련 설정에 해당 경로가 반영됩니다.
이를 이용하면 Windows 설치 과정에서 추가 파일이나 스크립트 등을 함께 구성하는 자동화 환경을 만들 수 있습니다.
8. /XmlFile
/XmlFile:<경로>
무인 설치에 사용할 XML 파일을 지정합니다.
예:
/XmlFile:"H:\AutoUnattend.xml"
또는
/XmlFile:"H:\unattend.xml"
소스에서는 지정된 XML 파일이 실제로 존재하는 경우 해당 기능을 활성화하고 GUI의 XML 입력 항목에도 경로를 반영합니다.
따라서 Command Line에서 이미지와 함께 무인 설치 XML까지 지정할 수 있습니다.
9. /DriversPath
/DriversPath:<경로>
설치 과정에서 사용할 드라이버 폴더를 지정합니다.
예:
/DriversPath:"H:\DRIVERS"
지정한 경로가 존재하면 드라이버 통합 옵션을 활성화하고 해당 경로를 GUI에 반영합니다.
따라서 별도의 GUI 조작 없이 Command Line에서 드라이버 경로까지 지정할 수 있습니다.
10. /after
/after:<Ready | Finish | Shutdown | Reboot | fw | ao>
설치 작업 완료 후 수행할 동작을 지정합니다.
지원되는 값은 다음과 같습니다.
옵션동작
| Ready | 작업 완료 후 대기 |
| Finish | 프로그램 종료 |
| Shutdown | 시스템 종료 |
| Reboot | 시스템 다시 시작 |
| fw | BIOS/UEFI 펌웨어 설정 진입 |
| ao | Finish와 동일하게 처리 |
예:
/after:Finish
설치 작업이 끝난 후 WinSetup64 프로그램을 종료합니다.
또는
/after:Reboot
설치 완료 후 시스템을 다시 시작하도록 지정할 수 있습니다.
11. /d
/d
기존 Windows 기본 부팅 항목을 보존하는 옵션입니다. 소스에서는 이 옵션이 지정되면 기존 기본 부팅 항목 정보를 보존한 후 bcdboot 작업 이후 이전 기본 항목을 복원하는 방식으로 처리하도록 구성되어 있습니다.
예:
WinSetup64.exe /ImageFile:"install.wim" /Index:1 /ApplyDrv:C: /d12. /Compact
/Compact
WIM 이미지 적용 시 wimlib의 Compact 모드를 적용합니다.
소스에서는 실제 wimlib 명령에 다음 옵션을 추가하도록 구현되어 있습니다.
--compact=xpress4k
즉,
/Compact
을 사용하면 내부적으로 이미지 적용 명령에
--compact=xpress4k
가 추가됩니다.
따라서 일반 이미지 적용과 Compact 이미지 적용을 Command Line에서 선택할 수 있습니다.
13. /ApplyStart
/ApplyStart
설치 시작 전에 표시되는 확인 과정을 생략하고 바로 이미지 설치를 시작하도록 하는 옵션입니다.
단독으로 사용하는 옵션이라기보다는 다음과 같이 설치에 필요한 주요 옵션들과 함께 사용하는 형태입니다.
/ApplyStart
소스에서는 다음 조건이 모두 충족될 경우 자동 설치를 시작하도록 되어 있습니다.
/ImageFile
/Index
/ApplyDrv
/ApplyStart
그리고 /BootDrv가 지정되어 있거나 설치 위치를 기준으로 자동 부팅 파티션을 찾을 수 있어야 실제 설치 과정으로 연결됩니다.
14. /SaveList
/SaveList:<경로>
이미지 파일에 포함된 Windows 이미지 목록을 텍스트 파일로 저장합니다.
이 옵션은 /ImageFile과 함께 사용하도록 구현되어 있습니다.
예:
WinSetup64.exe /ImageFile:"install.wim" /SaveList:"WimList.txt"
이 경우 GUI에서 직접 이미지를 선택하지 않고 WIM 이미지의 정보를 확인하여 지정한 텍스트 파일로 저장한 후 종료하는 방식으로 사용할 수 있습니다. 또한 v4.0의 탐색기 컨텍스트 메뉴 기능에서도 이 옵션이 활용됩니다.
예를 들어 소스에서는 이미지 파일 우클릭 메뉴의 이미지 목록 기능을 다음과 같이 등록합니다.
WinSetup64.exe /ImageFile:"%1" /SaveList:"WimList.txt"
따라서 Windows 탐색기에서 WIM/ESD/SWM/ISO 파일을 대상으로 이미지 정보를 확인하는 용도로도 활용할 수 있습니다.
15. /add
/add
Windows 탐색기의 우클릭 컨텍스트 메뉴에 WinSetup64 기능을 등록합니다.
소스에서는 다음 확장자를 대상으로 컨텍스트 메뉴를 등록합니다.
.wim
.esd
.swm
.iso
등록 작업을 완료하면 프로그램을 종료합니다.
예:
WinSetup64.exe /add16. /remove
/remove
WinSetup64에서 등록한 탐색기 우클릭 컨텍스트 메뉴를 제거합니다.
예:
WinSetup64.exe /remove
/add와 마찬가지로 작업 후 프로그램을 종료합니다.
Command Line 옵션 조합
v4.0의 Command Line 기능에서 중요한 부분은 각각의 옵션을 독립적으로 사용하는 것뿐만 아니라 여러 옵션을 조합하여 하나의 설치 작업으로 연결할 수 있다는 점입니다.
파티션 작업만 수행
WinSetup64.exe /Disk:6 /Preset:1
6번 디스크에 Preset_1의 파티션 구성을 적용합니다.
파티션 구성 후 Windows 자동 설치
WinSetup64.exe /ImageFile:"H:\install.iso" /Index:2 /Disk:6 /Preset:1 /ApplyDrv:W /BootDrv:- /ApplyStart
이 명령은 소스의 처리 순서에 따라 다음과 같이 동작합니다.
Disk 6 선택
↓
Preset 1 적용
↓
파티션 작업
↓
디스크 및 파티션 정보 갱신
↓
H:\install.iso 이미지 사용
↓
Index 2 선택
↓
W: 설치 대상 선택
↓
부팅 파티션 자동 검색
↓
/ApplyStart
↓
Windows 이미지 설치 시작WIM 이미지 설치 + Compact + 종료
WinSetup64.exe /ImageFile:"install.wim" /Index:1 /ApplyDrv:C: /after:Finish /Compact /d
이 경우 Index 1 이미지를 C:에 적용하고 Compact 옵션을 사용하며, 작업 완료 후 프로그램을 종료하도록 구성됩니다.
이미지 목록 저장
WinSetup64.exe /ImageFile:"install.wim" /SaveList:"WimList.txt"
WIM 이미지의 정보를 텍스트 파일로 저장하는 용도로 사용할 수 있습니다.
Command Line 입력 형식
v4.0의 Command Line 파서는 입력 형식도 비교적 유연하게 구성되어 있습니다.
소스에서는 다음과 같은 형태를 모두 인식합니다.
/Key:Value
Key:Value
또한 / 또는 \와 같은 접두사를 제거한 후 옵션을 비교하기 때문에 접두사에 따른 차이를 크게 두지 않도록 구현되어 있습니다.
대소문자 역시 구분하지 않습니다.
예를 들어 옵션 이름은 다음과 같이 사용할 수 있습니다.
/ImageFile:"install.wim"
/imagefile:"install.wim"
동일한 방식으로 처리됩니다.
v4.0 Command Line 연동의 핵심
WinSetup64 v4.0의 Command Line 기능을 전체적으로 보면 크게 세 단계로 나눌 수 있습니다.
1단계 — 디스크 구성
/Disk
/Preset↓
2단계 — Windows 설치 환경 설정
/ImageFile
/Index
/ApplyDrv
/BootDrv
/OemPath
/XmlFile
/DriversPath↓
3단계 — 설치 실행 및 완료 동작
/ApplyStart
/Compact
/d
/after
이러한 구조를 이용하면 WinSetup64을 단순히 GUI에서 사용하는 설치 프로그램이 아니라, 다른 자동화 프로그램에서 Command Line으로 호출하여 Windows 설치 과정을 연동하는 구성으로 사용할 수 있습니다. 특히 /Disk + /Preset + /ImageFile + /ApplyDrv + /BootDrv + /ApplyStart 조합은 v4.0에서 추가된 Command Line 설치 연동의 핵심적인 사용 형태입니다. 또한 /SaveList, /add, /remove와 같은 옵션을 별도로 제공하여 Windows 이미지 정보 확인 및 탐색기 컨텍스트 메뉴 연동까지 Command Line을 통해 처리할 수 있도록 구성하였습니다. 위 내용은 실제 WinSetup64 v4.0(1).au3 소스의 /ImageFile부터 /remove까지의 옵션 정의와 실제 처리 로직을 기준으로 작성한 것입니다. 특히 /Disk + /Preset이 이미지 설치보다 먼저 실행되는 부분과 /BootDrv:-, /ApplyStart, /Compact의 실제 처리 방식까지 소스에 맞춰 반영했습니다.
WinSetup64 Command Line 명령 연동 - 움짤(GIF)
'자작 프로그램 > WinSetup64' 카테고리의 다른 글
| WinSetup64 v4.0 - 기능 추가 및 개선 중 . . . (0) | 2026.09.25 |
|---|---|
| WinSetup64 v3.5 - 백업 추가 및 기능 소폭 개선 (0) | 2026.07.05 |
| WinSetup64 v3.0 - 메뉴얼 및 기능 소폭 개선 (0) | 2026.06.09 |
| WinSetup64 v2.0 - 기능 통합 최종 (2) | 2026.06.02 |
| 윈도우 설치 도구 V2 - 초안 샘플 (0) | 2026.05.29 |
