MsiPackage

Článek
05/05/2023

Synopse

Nainstalujte nebo odinstalujte balíček MSI.

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

Prostředek MsiPackage nainstaluje nebo odinstaluje balíček MSI. Balíček může být místní, na jednotce UNC nebo stažený z webového identifikátoru URI. Balíček můžete nainstalovat jako alternativní účet. Podle potřeby můžete zadat další argumenty balíčku pro instalaci nebo odinstalaci.

Požadavky

Žádné

Základní vlastnosti

ProductId

Zadejte identifikační číslo použité k vyhledání balíčku jako řetězce. Tato hodnota je obvykle identifikátor GUID.

Type: System.String

Povinné vlastnosti

Cesta

Zadejte cestu k balíčku MSI jako řetězec. Hodnota této vlastnosti může být cesta k souboru MSI na místním počítači, cesta k balíčku MSI na jednotce UNC nebo webový identifikátor URI, ze kterého lze balíček MSI stáhnout. Pokud hodnota této vlastnosti není webový identifikátor URI, musí končit .msi.

Tato vlastnost se používá pouze s metodou Set prostředku. Pokud je hodnota webový identifikátor URI, prostředek před instalací nebo odinstalací stáhne balíček do místní mezipaměti. Pokud je hodnota cesta UNC, prostředek připojí jednotku UNC před instalací nebo odinstalací.

Type: System.String

Volitelné vlastnosti

Argumenty

Zadejte další argumenty, které se mají předat balíčku během instalace nebo odinstalace jako řetězec. Vždy se předají následující argumenty:

Při instalaci /i <Path to the MSI package> je prvním argumentem.
Při odinstalaci /x <Product Entry Guid> je prvním argumentem.
Pokud je zadána cesta LogPath , připojí /log "<LogPath>" se prostředek k seznamu argumentů. Další informace najdete v tématu LogPath .
/quiet a /norestart jsou vždy připojeny.

Hodnota této vlastnosti je připojena za výchozí argumenty.

Type: System.String
Default Value: None

Přihlašovací údaj

V případě potřeby zadejte přihlašovací údaje účtu s oprávněním připojit cestu UNC.

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

Zajištění

Určuje, zda se má balíček nainstalovat nebo odinstalovat. Chcete-li balíček nainstalovat, zadejte tuto vlastnost jako Present. Chcete-li balíček odinstalovat, zadejte tuto vlastnost jako Absent. Výchozí hodnota je Present.

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

FileHash

Zadejte očekávanou hodnotu hash souboru MSI jako řetězec. Pokud je zadáno, prostředek před instalací nebo odinstalací balíčku zkontroluje balíček proti této hodnotě. Pokud se hodnoty neshodují, prostředek vyvolá neplatnou výjimku argumentu.

Type: System.String
Default Value: None

Hashalgorithm

Zadejte algoritmus použitý k vygenerování hodnoty fileHash. Výchozí hodnota je SHA256.

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

LogPath

Zadejte cestu k souboru pro protokolování výstupu ze spuštění MSI jako řetězec. Ve výchozím nastavení se výstup nezaprotokoluje.

Type: System.String
Default Value: None

RunAsCredential

Zadejte přihlašovací údaje alternativního účtu pro spuštění instalace nebo odinstalace balíčku jako.

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

ServerCertificateValidationCallback

Zadejte blok skriptu PowerShellu, který ověří certifikáty SSL, když je cesta identifikátorem URI HTTPS. Pokud se skriptblock nevrátí $true, metoda Set prostředku vyvolá neplatnou výjimku operace a nestahuje balíček.

Type: System.String
Default Value: None

SignerSubject

Zadejte předmět jako řetězec, který by měl odpovídat certifikátu podepisujícího digitálního podpisu souboru MSI. Pokud je zadáno, prostředek před instalací nebo odinstalací balíčku zkontroluje balíček proti této hodnotě. Pokud se hodnoty neshodují, metoda Set prostředku vyvolá neplatnou výjimku argumentu.

Type: System.String
Default Value: None

SignerThumbprint

Zadejte kryptografický otisk certifikátu jako řetězec, který by měl odpovídat certifikátu podepisujícího digitálního podpisu souboru MSI. Pokud je zadáno, prostředek před instalací nebo odinstalací balíčku zkontroluje balíček proti této hodnotě. Pokud se hodnoty neshodují, metoda Set prostředku vyvolá neplatnou výjimku argumentu.

Type: System.String
Default Value: None

Vlastnosti jen pro čtení

InstalledOn

Datum instalace balíčku MSI nebo jeho obsluha, podle toho, co je později. Tato vlastnost není konfigurovatelná.

Type: System.String

InstallSource

Cesta k balíčku MSI.

Type: System.String

Name

Zobrazovaný název balíčku MSI.

Type: System.String

PackageDescription

Popis balíčku MSI.

Type: System.String

Publisher

Vydavatel balíčku MSI.

Type: System.String

Velikost

Velikost balíčku MSI v MB.

Type: System.UInt32

Verze

Číslo verze balíčku MSI.

Type: System.String

Sdílet prostřednictvím