MsiPackage

아티클
05/05/2023

개요

MSI 패키지를 설치하거나 제거합니다.

구문

MsiPackage [String] #ResourceName
{
    Path = [string]
    ProductId = [string]
    [Arguments = [string]]
    [Credential = [PSCredential]]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [FileHash = [string]]
    [HashAlgorithm = [string]{ MD5 | RIPEMD160 | SHA1 | SHA256 | SHA384 | SHA512 }]
    [LogPath = [string]]
    [PsDscRunAsCredential = [PSCredential]]
    [RunAsCredential = [PSCredential]]
    [ServerCertificateValidationCallback = [string]]
    [SignerSubject = [string]]
    [SignerThumbprint = [string]]
}

Description

리소스는 MsiPackage MSI 패키지를 설치하거나 제거합니다. 패키지는 로컬, UNC 드라이브 또는 웹 URI에서 다운로드할 수 있습니다. 패키지를 대체 계정으로 설치할 수 있습니다. 필요에 따라 설치 또는 제거를 위해 패키지에 대한 추가 인수를 지정할 수 있습니다.

요구 사항

없음

키 속성

ProductId

패키지를 문자열로 찾는 데 사용되는 식별 번호를 지정합니다. 이 값은 일반적으로 GUID입니다.

Type: System.String

필수 속성

경로

MSI 패키지의 경로를 문자열로 지정합니다. 이 속성의 값은 로컬 컴퓨터의 MSI 파일 경로, UNC 드라이브의 MSI 패키지 경로 또는 MSI 패키지를 다운로드할 수 있는 웹 URI일 수 있습니다. 이 속성의 값이 웹 URI가 아니면 다음으로 .msi끝나야 합니다.

이 속성은 리소스의 Set 메서드에만 사용됩니다. 값이 웹 URI인 경우 리소스는 설치하거나 제거하기 전에 패키지를 로컬 캐시에 다운로드합니다. 값이 UNC 경로인 경우 리소스는 UNC 드라이브를 설치하거나 제거하기 전에 탑재합니다.

Type: System.String

선택적 속성

인수

설치 또는 제거 중에 패키지에 전달할 추가 인수를 문자열로 지정합니다. 다음 인수는 항상 전달됩니다.

설치할 /i <Path to the MSI package> 때 첫 번째 인수입니다.
제거할 /x <Product Entry Guid> 때 첫 번째 인수입니다.
LogPath를 지정하면 리소스가 인수 목록에 추가됩니다/log "<LogPath>". 자세한 내용은 LogPath 를 참조하세요.
/quiet 항상 /norestart 추가됩니다.

이 속성의 값은 기본 인수 후에 추가됩니다.

Type: System.String
Default Value: None

자격 증명

필요한 경우 UNC 경로를 탑재할 수 있는 권한이 있는 계정의 자격 증명을 지정합니다.

Type: System.Management.Automation.PSCredential
Behavior: Write
Default Value: None

Ensure

패키지를 설치하거나 제거할지 여부를 지정합니다. 패키지를 설치하려면 이 속성을 .로 Present지정합니다. 패키지를 제거하려면 이 속성을 로 Absent지정합니다. 기본값은 Present입니다.

Type: System.String
Behavior: Write
Accepted Values:
  - Absent
  - Present
Default Value: Present

FileHash

MSI 파일의 예상 해시 값을 문자열로 지정합니다. 지정된 경우 리소스는 패키지를 설치하거나 제거하기 전에 이 값에 대해 패키지를 확인합니다. 값이 일치하지 않으면 리소스가 잘못된 인수 예외를 throw합니다.

Type: System.String
Default Value: None

HashAlgorithm

FileHash 값을 생성하는 데 사용되는 알고리즘을 지정합니다. 기본값은 SHA256입니다.

Type: System.String
Accepted Values:
  - MD5
  - RIPEMD160
  - SHA1
  - SHA256
  - SHA384
  - SHA512
Default Value: SHA256

LogPath

MSI 실행의 출력을 문자열로 로깅하기 위한 파일 경로를 지정합니다. 기본적으로 출력은 기록되지 않습니다.

Type: System.String
Default Value: None

RunAsCredential

패키지의 설치 또는 제거를 실행할 대체 계정의 자격 증명을 지정합니다.

Type: System.Management.Automation.PSCredential
Default Value: None

ServerCertificateValidationCallback

경로가 HTTPS URI인 경우 SSL 인증서의 유효성을 검사하는 PowerShell scriptblock을 지정합니다. scriptblock이 반환 $true되지 않으면 리소스의 Set 메서드가 잘못된 작업 예외를 throw하고 패키지를 다운로드하지 않습니다.

Type: System.String
Default Value: None

SignerSubject

MSI 파일의 디지털 서명의 서명자 인증서와 일치해야 하는 문자열로 제목을 지정합니다. 지정된 경우 리소스는 패키지를 설치하거나 제거하기 전에 이 값에 대해 패키지를 확인합니다. 값이 일치하지 않으면 리소스의 Set 메서드가 잘못된 인수 예외를 throw합니다.

Type: System.String
Default Value: None

SignerThumbprint

인증서 지문을 MSI 파일 디지털 서명의 서명자 인증서와 일치해야 하는 문자열로 지정합니다. 지정된 경우 리소스는 패키지를 설치하거나 제거하기 전에 이 값에 대해 패키지를 확인합니다. 값이 일치하지 않으면 리소스의 Set 메서드가 잘못된 인수 예외를 throw합니다.

Type: System.String
Default Value: None

읽기 전용 속성

InstalledOn

MSI 패키지가 설치되었거나 서비스된 날짜입니다. 이 속성은 구성할 수 없습니다.

Type: System.String

InstallSource

MSI 패키지의 경로입니다.

Type: System.String

Name

MSI 패키지의 표시 이름입니다.

Type: System.String

PackageDescription

MSI 패키지에 대한 설명입니다.

Type: System.String

게시자

MSI 패키지의 게시자입니다.

Type: System.String

크기

MSI 패키지의 크기(MB)입니다.

Type: System.UInt32

버전

MSI 패키지의 버전 번호입니다.

Type: System.String