Installer.ApplyPatch 메서드

  • 아티클

패치 패키지에 의해 패치를 받을 수 있는 것으로 나열된 각 제품에 대해 Installer 개체의 ApplyPatch 메서드는 설치를 호출하고 PATCH 속성을 패치 패키지의 경로로 설정합니다.

구문

Installer.ApplyPatch(
  PatchPackage,
  InstallPackage,
  InstallType,
  CommandLine
)

매개 변수

PatchPackage

패치 패키지의 경로를 지정합니다.

InstallPackage

InstallType이 msiInstallTypeNetworkImage로 설정된 경우 InstallPackage는 패치할 제품의 경로를 지정합니다. InstallType이 msiInstallTypeDefault로 설정되고 InstallPackage가 0으로 설정되면 설치 관리자는 패치 패키지에 나열된 모든 적합한 제품에 패치를 적용합니다.

InstallType이 msiInstallTypeSingleInstance인 경우 설치 관리자는 InstallPackage에서 지정한 제품에 패치를 적용합니다. 이 경우 패치 패키지에 나열된 다른 적격 제품은 무시되고 InstallPackage 매개 변수에는 패치할 인스턴스의 제품 코드를 나타내는 null로 끝나는 문자열이 포함됩니다. 이 유형의 설치에는 Windows Server 2003 이상 또는 Windows Installer XP SP1 이상과 함께 제공되는 Windows Installer 버전이 필요합니다.

InstallType

이 매개 변수는 패치할 설치 유형을 지정합니다. InstallPackage를 생략하면 InstallType 매개 변수가 무시됩니다.

값 의미
msiInstallTypeNetworkImage
 관리 설치를 나타냅니다. 이 경우 InstallPackage를 패키지 경로로 설정해야 합니다. msiInstallTypeNetworkImage의 값 1은 관리자 설치를 지정합니다.
msiInstallTypeDefault
 패치할 제품을 시스템에서 검색합니다. 이 경우 InstallPackage는 빈 문자열이어야 합니다.
msiInstallSingleInstance
 InstallPackage에서 지정한 제품을 패치합니다. InstallPackage는 패치할 인스턴스의 제품 코드입니다. 이 유형의 설치에는 Windows Server 2003 이상 또는 Windows Installer XP SP1 이상과 함께 제공되는 Windows Installer 버전이 필요합니다. 자세한 내용은 제품 및 패치의 여러 인스턴스 설치를 참조하세요.

 

CommandLine

명령줄에서 설정 중인 속성 설정을 지정합니다. 설명 섹션을 참조하십시오.

반환 값

이 메서드는 값을 반환하지 않습니다.

설명

변환, 소스 및 패치의 목록 구분 기호는 세미콜론이므로 파일 이름이나 경로에 이 문자를 사용하면 안 됩니다.

소규모 업데이트 또는 부분 업그레이드 패치를 적용할 때 REINSTALL 속성이 필요합니다. 이 속성이 없으면 패치가 시스템에 등록되지만 파일을 업데이트할 수 없습니다.

Windows Installer 2.0:소규모 업데이트 또는 부분 업그레이드 패치를 적용할 때 명령줄에서 REINSTALL 속성을 설정해야 합니다. 사용자 지정 작업 유형 51을 사용하여 REINSTALL 및 REINSTALLMODE 속성을 자동으로 설정하지 않는 패치의 경우 CommandLine 매개 변수를 사용하여 REINSTALL 속성을 명시적으로 설정해야 합니다. REINSTALL 속성을 설정하여 패치의 영향을 받는 기능을 나열하거나 실제 기본 설정인 "REINSTALL=ALL"을 사용합니다. REINSTALLMODE 속성의 기본값은 "omus"입니다.

Windows Installer 3.0 이상: Windows Installer 버전 3.0부터 REINSTALL 속성은 설치 관리자에 의해 구성되며 명령줄에서 설정할 필요가 없습니다.

요구 사항

요구 사항 값
버전
 Windows Server 2012, Windows 8, Windows Server 2008 R2 또는 Windows 7의 Windows Installer 5.0. Windows Server 2008 또는 Windows Vista의 Windows Installer 4.0 또는 Windows Installer 4.5. Windows Server 2003 또는 Windows XP의 Windows Installer 3.0 이상.
DLL
Msi.dll
IID
 IID_IInstaller는 000C1090-0000-0000-C000-000000000046으로 정의됩니다.

추가 정보

MsiApplyPatch

속성 정보

Windows Installer 2.0 이하에서 지원되지 않음