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]]
}

説明

リソースは MsiPackage MSI パッケージをインストールまたはアンインストールします。パッケージは、ローカル、UNC ドライブ、または Web URI からダウンロードできます。代替アカウントとしてパッケージをインストールできます。必要に応じて、インストールまたはアンインストールのためにパッケージに追加の引数を指定できます。

要件

[なし] :

キーのプロパティ

ProductId

パッケージを文字列として検索するために使用する識別番号を指定します。通常、この値は GUID です。

Type: System.String

必須プロパティ

パス

MSI パッケージへのパスを文字列として指定します。このプロパティの値には、ローカルコンピューター上の MSI ファイルへのパス、UNC ドライブ上の MSI パッケージへのパス、または MSI パッケージのダウンロード元の Web URI を指定できます。このプロパティの値が Web URI でない場合は、次で終わる .msi必要があります。

このプロパティは、リソースの Set メソッドでのみ使用されます。値が Web 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 ファイルの予想されるハッシュ値を文字列として指定します。指定した場合、リソースはパッケージをインストールまたはアンインストールする前に、この値に照らしてパッケージをチェックします。値が一致しない場合、リソースは無効な引数例外をスローします。

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

Path が HTTPS URI の場合に SSL 証明書を検証する PowerShell スクリプトブロックを指定します。 scriptblock が返 $trueされない場合、リソースの Set メソッドは無効な操作例外をスローし、パッケージをダウンロードしません。

Type: System.String
Default Value: None

SignerSubject

MSI ファイルのデジタル署名の署名者証明書と一致する文字列としてサブジェクトを指定します。指定した場合、リソースはパッケージをインストールまたはアンインストールする前に、この値に照らしてパッケージをチェックします。値が一致しない場合、リソースの Set メソッドは無効な引数例外をスローします。

Type: System.String
Default Value: None

SignerThumbprint

証明書の拇印を、MSI ファイルのデジタル署名の署名者証明書と一致する文字列として指定します。指定した場合、リソースはパッケージをインストールまたはアンインストールする前に、この値に照らしてパッケージをチェックします。値が一致しない場合、リソースの Set メソッドは無効な引数例外をスローします。

Type: System.String
Default Value: None

読み取り専用プロパティ

InstalledOn

MSI パッケージがインストールまたは処理された日付 (遅い方)。このプロパティは構成できません。

Type: System.String

InstallSource

MSI パッケージへのパス。

Type: System.String

名前

MSI パッケージの表示名。

Type: System.String

PackageDescription

MSI パッケージの説明。

Type: System.String

Publisher

MSI パッケージの発行元。

Type: System.String

サイズ

MSI パッケージのサイズ (MB 単位)。

Type: System.UInt32

バージョン

MSI パッケージのバージョン番号。

Type: System.String

次の方法で共有