다음을 통해 공유


명령줄 옵션

패키지를 해석하고 제품을 설치하는 실행 프로그램은 Msiexec.exe입니다. Msiexec는 또한 반환 시 시스템 오류 코드에 해당하는 오류 수준을 설정합니다. 명령줄 옵션은 대/소문자를 구분하지 않습니다.

다음 표의 명령줄 옵션은 Windows Installer 3.0 및 이전 버전에서 사용할 수 있습니다. 또한 표준 설치 관리자 명령줄 옵션도 Windows Installer 3.0부터 사용할 수 있습니다.

옵션 매개 변수 의미
/I Package|ProductCode 제품을 설치하거나 구성합니다.
/f [p|o|e|d|c|a|u|m|s|v] Package|ProductCode 제품을 복구합니다. 이 옵션은 명령줄에 입력한 모든 속성 값을 무시합니다. 이 옵션의 기본 인수 목록은 ‘omus’입니다. 이 옵션은 REINSTALLMODE 속성과 동일한 인수 목록을 공유합니다.
p - 파일이 누락된 경우에만 다시 설치합니다.
o - 파일이 누락되었거나 이전 버전이 설치된 경우 다시 설치합니다.
e - 파일이 누락되었거나 동일한 버전 또는 이전 버전이 설치된 경우 다시 설치합니다.
d - 파일이 누락되었거나 다른 버전이 설치된 경우 다시 설치합니다.
c - 파일이 누락되었거나 저장된 체크섬이 계산된 값과 일치하지 않는 경우 다시 설치합니다. 파일 테이블의 특성 열에 msidbFileAttributesChecksum이 있는 파일만 복구합니다.
a - 모든 파일을 강제로 다시 설치합니다.
u - 필요한 모든 사용자별 레지스트리 항목을 다시 작성합니다.
m - 필요한 모든 컴퓨터별 레지스트리 항목을 다시 작성합니다.
s - 모든 기존 바로 가기를 덮어씁니다.
v - 원본에서 실행하고 로컬 패키지를 다시 캐시합니다. 애플리케이션 또는 기능의 첫 번째 설치에는 v 다시 설치 옵션을 사용하지 않습니다.
/a 패키지 관리 설치 옵션입니다. 네트워크에 제품을 설치합니다.
/x Package|ProductCode 제품을 제거합니다.
/j [u|m]Packageor
[u|m]Package/tTransform List
or
[u|m]Package/gLanguageID
제품을 보급합니다. 이 옵션은 명령줄에 입력한 모든 속성 값을 무시합니다.
u - 현재 사용자에게 보급합니다.
m - 머신의 모든 사용자에게 보급합니다.
g - 언어 식별자입니다.
t - 보급된 패키지에 변환을 적용합니다.
/L [i|w|e|a|r|u|c|m|o|p|v|x|+|!|*] Logfile 지정된 기존 경로의 로그 파일에 로깅 정보를 씁니다. 로그 파일 위치의 경로가 이미 있어야 합니다. 설치 관리자는 logfile의 디렉터리 구조를 만들지 않습니다. 플래그는 로깅할 정보를 나타냅니다. 플래그를 지정하지 않은 경우 기본값은 ‘iwearmo’입니다.
i - 상태 메시지
w - 심각하지 않은 경고
e - 모든 오류 메시지
a - 작업 시작
r - 작업 관련 레코드
u - 사용자 요청
c - 초기 UI 매개 변수
m - 메모리 부족 또는 심각한 종료 정보
o - 디스크 공간 부족 메시지
p - 터미널 속성
v – 세부 정보 표시 출력
x - 추가 디버깅 정보 Windows Installer 2.0 버전에서는 지원되지 않습니다. x 옵션은 Windows Installer 버전 3.0.3790.2180 이상에서 사용할 수 있습니다.

+ - 기존 파일 추가
! - 각 줄을 로그에 플러시
“*” - 와일드카드로 v 및 x 옵션을 제외한 모든 정보 로그 v 및 x 옵션을 포함하려면 “/l*vx”를 지정합니다.

참고:
로깅 모드를 설정하는 데 사용할 수 있는 모든 방법에 대한 자세한 내용은 Windows Installer 로깅 섹션의 일반 로깅을 참조하세요.


/m filename

참고:
파일 이름의 길이는 8자 이하여야 합니다.


SMS 상태 .mif 파일을 생성합니다. 설치(-i), 제거(-x), 관리 설치(-a) 또는 다시 설치(-f) 옵션과 함께 사용해야 합니다. ISMIF32.DLL은 SMS의 일부로 설치되며 경로에 있어야 합니다.
상태 mif 파일의 필드는 다음 정보로 채워집니다.
제조업체 - 작성자
제품 - 수정 번호
버전 - 제목
로캘 - 템플릿
일련 번호 - 설정되지 않음
설치 - ISMIF32.DLL에서 "DateTime"으로 설정
InstallStatus - “성공” 또는 “실패”
설명 - 오류 메시지 순서: 1) 설치 관리자에서 생성된 오류 메시지입니다. 2) 설치를 시작할 수 없거나 사용자가 종료할 수 없는 경우 Msi.dll의 리소스입니다. 3) 시스템 오류 메시지 파일입니다. 4) 형식이 지정된 메시지: “설치 관리자 오류 %i”입니다. 여기서 %i는 Msi.dll에서 반환된 오류입니다.
/p PatchPackage[;patchPackage2 ] 패치를 적용합니다. 설치된 관리 이미지에 패치를 적용하려면 다음 옵션을 결합해야 합니다.
/p <PatchPackage>[;p atchPackage2 ] /a \<Package>
/q n|b|r|f 사용자 인터페이스 수준을 설정합니다.
q , qn - UI 없음
qb - 기본 UI. qb! 취소 단추를 숨 깁니다.
qr - 설치가 끝날 때 모달 대화 상자가 표시되지 않고 UI가 줄어듭니다 .
qf - 전체 UI 및 작성된 모든 FatalError, UserExit 또는 종료 모달 대화 상자가 끝에 있습니다.
qn+ - 끝에 표시되는 모달 대화 상자를 제외하고 UI가 없습니다.
qb+ - 끝에 모달 대화 상자가 표시된 기본 UI 입니다. 사용자가 설치를 취소하면 모달 상자가 표시되지 않습니다. qb+! 또는 qb!+를 사용하여 취소 단추를 숨깁니다.
qb- - 모달 대화 상자가 없는 기본 UI 입니다. /qb+-는 지원되는 UI 수준이 아닙니다. qb-! 또는 qb!- 취소 단추를 숨깁니다.
참고로 ! 옵션은 Windows Installer 2.0에서 사용할 수 있으며 기본 UI에서만 작동합니다. 전체 UI에는 유효하지 않습니다.
/? 또는 /h Windows Installer에 대한 저작권 정보를 표시합니다.
/Y 모듈(module) 시스템 함수 DllRegisterServer 를 호출하여 명령줄에 전달된 모듈을 자체 등록합니다. DLL의 전체 경로를 지정합니다. 예를 들어 현재 폴더의 MY_FILE.DLL 사용할 수 있습니다.
msiexec /y .\MY_FILE.DLL
이 옵션은 .msi 파일의 레지스트리 테이블을 사용하여 추가할 수 없는 레지스트리 정보에만 사용됩니다.
/Z 모듈(module) 시스템 함수 DllUnRegisterServer 를 호출하여 명령줄에 전달된 모듈의 등록을 취소합니다. DLL의 전체 경로를 지정합니다. 예를 들어 현재 폴더의 MY_FILE.DLL 사용할 수 있습니다.
msiexec /z .\MY_FILE.DLL
이 옵션은 .msi 파일의 레지스트리 테이블을 사용하여 제거할 수 없는 레지스트리 정보에만 사용됩니다.
/c 제품의 새 인스턴스를 보급합니다. /t와 함께 사용해야 합니다. Windows Server 2003 및 Windows XP SP1(서비스 팩 1)과 함께 제공되는 Windows Installer 버전부터 사용할 수 있습니다.
/n ProductCode 제품의 특정 인스턴스를 지정합니다. 제품 코드 변경 변환을 통해 여러 인스턴스 지원을 사용하여 설치된 인스턴스를 식별하는 데 사용됩니다. Windows Server 2003 및 Windows XP SP1과 함께 제공되는 Windows Installer 버전부터 사용할 수 있습니다.

/i, /x, /f[p|o|e|d|c|a|u|m|s|v], /j[u|m], /a, /p, /y, /z 옵션은 함께 사용할 수 없습니다. 이 규칙의 한 가지 예외는 관리 설치를 패치하려면 /p와 /a를 모두 사용해야 한다는 것입니다. /t, /c, /g 옵션은 /j와 함께 사용해야만 합니다. /l와 /q 옵션은 /i, /x, /f[p|o|e|d|c|a|u|m|s|v], /j[u|m], /a, /p 옵션과 함께 사용할 수 있습니다. /n 옵션은 /i, /f, /x, /p와 함께 사용할 수 있습니다.

A:\Example.msi에서 제품을 설치하려면 다음과 같이 제품을 설치합니다.

msiexec /i A:\Example.msi

명령줄을 사용하여 퍼블릭 속성만 수정할 수 있습니다. 명령줄의 모든 속성 이름은 대문자로 해석되지만 값은 대/소문자 구분을 유지합니다. 명령줄에 MyProperty를 입력하면 설치 관리자가 속성 테이블의 MyProperty 값이 아닌 MYPROPERTY 값을 재정의합니다. 자세한 내용은 속성 정보를 참조하세요.

PROPERTY가 VALUE로 설정된 제품을 설치하려면 명령줄에서 다음 구문을 사용합니다. 옵션과 인수 사이를 제외한 모든 위치에 속성을 배치할 수 있습니다.

잘못된 구문:

msiexec /i A:\Example.msi PROPERTY=VALUE

잘못된 구문:

msiexec /i PROPERTY=VALUE A:\Example.msi

리터럴 문자열인 속성 값은 따옴표로 묶어야 합니다. 표시 사이의 문자열에 공백을 포함합니다.

msiexec /i A:\Example.msi PROPERTY="Embedded White Space"

명령줄을 사용하여 퍼블릭 속성을 지우려면 해당 값을 빈 문자열로 설정합니다.

msiexec /i A:\Example.msi PROPERTY=""

리터럴 따옴표로 구분된 텍스트 섹션의 경우 섹션을 두 번째 따옴표 쌍으로 묶습니다.

msiexec /i A:\Example.msi PROPERTY="Embedded ""Quotes"" White Space"

다음 예제에서는 복잡한 명령줄을 보여 줍니다.

msiexec /i testdb.msi INSTALLLEVEL=3 /l* msi.log COMPANYNAME="Acme ""Widgets"" and ""Gizmos."""

다음 예제에서는 보급 옵션을 보여 줍니다. 스위치는 대/소문자를 구분하지 않습니다.

msiexec /JM msisample.msi /T transform.mst /LIME logfile.txt

다음 예제에서는 보급할 제품의 새 인스턴스를 설치하는 방법을 보여 줍니다. 이 제품은 여러 인스턴스 변환을 지원하기 위해 작성되었습니다.

msiexec /JM msisample.msi /T :instance1.mst;customization.mst /c /LIME logfile.txt

다음 예제에서는 여러 인스턴스 변환을 사용하여 설치된 제품의 인스턴스를 패치하는 방법을 보여 줍니다.

msiexec /p msipatch.msp;msipatch2.msp /n {00000001-0002-0000-0000-624474736554} /qb

특정 제품에 패치를 적용하는 경우 명령줄에서 /i 및 /p 옵션을 함께 지정할 수 없습니다. 이 경우 다음과 같이 제품에 패치를 적용할 수 있습니다.

msiexec /i A:\Example.msi PATCH=msipatch.msp;msipatch2.msp /qb

/p 옵션을 사용하는 경우 PATCH 속성을 명령줄에 설정할 수 없습니다. /p 옵션을 사용할 때 PATCH 속성을 설정하면 PATCH 속성 값이 무시되고 덮어쓰여집니다.