MsiPackage

Artikel
05/05/2023

Synopsis

Installera eller avinstallera ett MSI-paket.

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

Description

Resursen MsiPackage installerar eller avinstallerar ett MSI-paket. Paketet kan vara lokalt, på en UNC-enhet eller laddas ned från en webb-URI. Du kan installera paketet som ett alternativt konto. Du kan ange ytterligare argument till paketet för installation eller avinstallation efter behov.

Krav

Inga.

Nyckelegenskaper

ProductId

Ange det identifieringsnummer som används för att hitta paketet som en sträng. Det här värdet är vanligtvis ett GUID.

Type: System.String

Obligatoriska egenskaper

Sökväg

Ange sökvägen till MSI-paketet som en sträng. Värdet för den här egenskapen kan vara sökvägen till en MSI-fil på den lokala datorn, sökvägen till ett MSI-paket på en UNC-enhet eller en webb-URI där MSI-paketet kan laddas ned. Om den här egenskapens värde inte är en webb-URI måste den sluta med .msi.

Den här egenskapen används endast med resursens Set-metod . Om värdet är en webb-URI laddar resursen ned paketet till en lokal cache innan du installerar eller avinstallerar. Om värdet är en UNC-sökväg monterar resursen UNC-enheten innan den installeras eller avinstalleras.

Type: System.String

Valfria egenskaper

Argument

Ange de ytterligare argument som ska skickas till paketet under installationen eller avinstallationen som en sträng. Följande argument skickas alltid:

När du /i <Path to the MSI package> installerar är det första argumentet.
När du avinstallerar /x <Product Entry Guid> är det första argumentet.
Om LogPath anges läggs /log "<LogPath>" resursen till i argumentlistan. Mer information finns i LogPath .
/quiet och /norestart läggs alltid till.

Värdet för den här egenskapen läggs till efter standardargumenten.

Type: System.String
Default Value: None

Autentiseringsuppgift

Ange autentiseringsuppgifterna för ett konto med behörighet att montera en UNC-sökväg om det behövs.

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

Säkerställa

Anger om paketet ska installeras eller avinstalleras. Om du vill installera paketet anger du den här egenskapen som Present. Om du vill avinstallera paketet anger du den här egenskapen som Absent. Standardvärdet är Present.

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

FileHash

Ange det förväntade hashvärdet för MSI-filen som en sträng. Om det anges kontrollerar resursen paketet mot det här värdet innan paketet installeras eller avinstalleras. Om värdena inte matchar utlöser resursen ett ogiltigt argumentfel.

Type: System.String
Default Value: None

HashAlgorithm

Ange den algoritm som används för att generera värdet för FileHash. Standardvärdet är SHA256.

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

LogPath

Ange sökvägen till en fil för att logga utdata från MSI-körningen som en sträng. Som standard loggas inte utdata.

Type: System.String
Default Value: None

RunAsCredential

Ange autentiseringsuppgifterna för ett alternativt konto för att köra installationen eller avinstallationen av paketet som.

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

ServerCertificateValidationCallback

Ange ett PowerShell-skriptblock för att verifiera SSL-certifikat när sökvägen är en HTTPS-URI. Om scriptblock inte returnerar $truegenererar resursens Set-metod ett ogiltigt åtgärdsfel och laddar inte ned paketet.

Type: System.String
Default Value: None

SignerSubject

Ange ämnet som en sträng som ska matcha undertecknarcertifikatet för MSI-filens digitala signatur. Om det anges kontrollerar resursen paketet mot det här värdet innan paketet installeras eller avinstalleras. Om värdena inte matchar utlöser resursens Set-metod ett ogiltigt argumentfel.

Type: System.String
Default Value: None

SignerThumbprint

Ange tumavtrycket för certifikatet som en sträng som ska matcha signeringscertifikatet för MSI-filens digitala signatur. Om det anges kontrollerar resursen paketet mot det här värdet innan paketet installeras eller avinstalleras. Om värdena inte matchar utlöser resursens Set-metod ett ogiltigt argumentfel.

Type: System.String
Default Value: None

Skrivskyddade egenskaper

InstalledOn

Det datum då MSI-paketet installerades på eller betjänades, beroende på vilket som inträffar senare. Den här egenskapen kan inte konfigureras.

Type: System.String

InstallSource

Sökvägen till MSI-paketet.

Type: System.String

Name

Visningsnamnet för MSI-paketet.

Type: System.String

PackageDescription

Beskrivning av MSI-paketet.

Type: System.String

Publisher

Utgivaren av MSI-paketet.

Type: System.String

Storlek

Storleken på MSI-paketet i MB.

Type: System.UInt32

Version

Versionsnumret för MSI-paketet.

Type: System.String

Share via