MsiPackage
Ü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 .msi
enden.
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 $true
wird, 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
- Installieren Sie die MSI-Datei mit der angegebenen ID im angegebenen Pfad
- Deinstallieren Der MSI-Datei mit der angegebenen ID im angegebenen Pfad
- Installieren Sie die MSI-Datei mit der angegebenen ID in der angegebenen HTTPS-URL
- Deinstallieren Der MSI-Datei mit der angegebenen ID in der angegebenen HTTPS-URL