MsiPackage

  • Artikel

Übersicht

Installieren oder Deinstallieren eines MSI-Pakets.

Syntax

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

BESCHREIBUNG

Die MsiPackage Ressource installiert oder deinstalliert ein MSI-Paket. Das Paket kann lokal, auf einem UNC-Laufwerk oder aus einem Web-URI heruntergeladen werden. Sie können das Paket als alternatives Konto installieren. Sie können nach Bedarf zusätzliche Argumente für das Paket für die Installation oder Deinstallation angeben.

Requirements (Anforderungen)

Keine

Schlüsseleigenschaften

ProductId

Geben Sie die identifizierte Zahl an, die zum Suchen des Pakets als Zeichenfolge verwendet wird. Dieser Wert ist in der Regel eine GUID.

Type: System.String

Obligatorische Eigenschaften

Pfad

Geben Sie den Pfad zum MSI-Paket als Zeichenfolge an. Der Wert dieser Eigenschaft kann der Pfad zu einer MSI-Datei auf dem lokalen Computer, dem Pfad zu einem MSI-Paket auf einem UNC-Laufwerk oder einem Web-URI sein, von dem das MSI-Paket heruntergeladen werden kann. Wenn der Wert dieser Eigenschaft kein Web-URI ist, muss sie mit .msienden.

Diese Eigenschaft wird nur mit der Set-Methode der Ressource verwendet. Wenn der Wert ein Web-URI ist, lädt die Ressource das Paket vor der Installation oder Deinstallation auf einen lokalen Cache herunter. Wenn der Wert ein UNC-Pfad ist, stellt die Ressource das UNC-Laufwerk vor der Installation oder Deinstallation bereit.

Type: System.String

Optionale Eigenschaften

Argumente

Geben Sie die zusätzlichen Argumente an, die beim Installieren oder Aufheben der Installation an das Paket übergeben werden sollen. Die folgenden Argumente werden immer übergeben:

  • Bei der /i <Path to the MSI package> Installation handelt es sich um das erste Argument.
  • Beim Deinstallieren /x <Product Entry Guid> ist das erste Argument.
  • Wenn LogPath angegeben wird, fügt die Ressource an die Argumentliste an /log "<LogPath>" . Weitere Informationen finden Sie unter LogPath .
  • /quiet und /norestart werden immer angefügt.

Der Wert dieser Eigenschaft wird nach den Standardargumenten angefügt.

Type: System.String
Default Value: None

Anmeldeinformationen

Geben Sie die Anmeldeinformationen eines Kontos mit Berechtigung zum Bereitstellen eines UNC-Pfads an, falls erforderlich.

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

Ensure

Gibt an, ob das Paket installiert oder deinstalliert werden soll. Um das Paket zu installieren, geben Sie diese Eigenschaft als Present. Um das Paket zu deinstallieren, geben Sie diese Eigenschaft als Absent. Standardwert: Present.

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

Dateihash

Geben Sie den erwarteten Hashwert der MSI-Datei als Zeichenfolge an. Wenn angegeben, überprüft die Ressource das Paket anhand dieses Werts, bevor Sie das Paket installieren oder deinstallieren. Wenn die Werte nicht übereinstimmen, löst die Ressource eine ungültige Argument ausnahme aus.

Type: System.String
Default Value: None

HashAlgorithm

Geben Sie den Algorithmus an, der zum Generieren des Werts für FileHash verwendet wird. Standardwert: SHA256.

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

LogPath

Geben Sie den Pfad einer Datei für die Protokollierung der Ausgabe aus der MSI-Ausführung als Zeichenfolge an. Standardmäßig wird die Ausgabe nicht protokolliert.

Type: System.String
Default Value: None

RunAsCredential

Geben Sie die Anmeldeinformationen eines alternativen Kontos an, um die Installation oder Deinstallation des Pakets auszuführen.

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

ServerCertificateValidationCallback

Geben Sie einen PowerShell-Skriptblock an, um SSL-Zertifikate zu überprüfen, wenn Path ein HTTPS-URI ist. Wenn der Skriptblock nicht zurückgegeben $truewird, löst die Set-Methode der Ressource eine ungültige Vorgangs ausnahme aus und lädt das Paket nicht herunter.

Type: System.String
Default Value: None

SignerSubject

Geben Sie den Betreff als Zeichenfolge an, die dem Signierzertifikat der digitalen Signatur der MSI-Datei entspricht. Wenn angegeben, überprüft die Ressource das Paket anhand dieses Werts, bevor Sie das Paket installieren oder deinstallieren. Wenn die Werte nicht übereinstimmen, löst die Set-Methode der Ressource eine ungültige Argument ausnahme aus.

Type: System.String
Default Value: None

SignerThumbprint

Geben Sie den Zertifikat-Fingerabdruck als Zeichenfolge an, die dem Signierzertifikat der digitalen Signatur der MSI-Datei entspricht. Wenn angegeben, überprüft die Ressource das Paket anhand dieses Werts, bevor Sie das Paket installieren oder deinstallieren. Wenn die Werte nicht übereinstimmen, löst die Set-Methode der Ressource eine ungültige Argument ausnahme aus.

Type: System.String
Default Value: None

Schreibgeschützte Eigenschaften

InstalliertOn

Das Datum, an dem das MSI-Paket installiert oder aktiviert wurde, was später geschieht. Diese Eigenschaft ist nicht konfigurierbar.

Type: System.String

InstallSource

Der Pfad zum MSI-Paket.

Type: System.String

Name

Der Anzeigename des MSI-Pakets.

Type: System.String

PackageDescription

Die Beschreibung des MSI-Pakets.

Type: System.String

Herausgeber

Der Herausgeber des MSI-Pakets.

Type: System.String

Size

Die Größe des MSI-Pakets in MB.

Type: System.UInt32

Version

Die Versionsnummer des MSI-Pakets.

Type: System.String

Beispiele