Pakiet MsiPackage

  • Artykuł

Streszczenie

Instalowanie lub odinstalowywanie pakietu MSI.

Składnia

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

Opis

Zasób MsiPackage instaluje lub odinstalowuje pakiet MSI. Pakiet może być lokalny, na dysku UNC lub pobrany z internetowego identyfikatora URI. Pakiet można zainstalować jako konto alternatywne. W razie potrzeby można określić dodatkowe argumenty dla pakietu na potrzeby instalacji lub dezinstalacji.

Wymagania

Brak.

Kluczowe właściwości

ProductId

Określ numer identyfikacyjny używany do znalezienia pakietu jako ciągu. Ta wartość jest zwykle identyfikatorem GUID.

Type: System.String

Właściwości obowiązkowe

Ścieżka

Określ ścieżkę do pakietu MSI jako ciąg. Wartość tej właściwości może być ścieżką do pliku MSI na komputerze lokalnym, ścieżką do pakietu MSI na dysku UNC lub identyfikatorem URI sieci Web, z którego można pobrać pakiet MSI. Jeśli wartość tej właściwości nie jest identyfikatorem URI sieci Web, musi kończyć się ciągiem .msi.

Ta właściwość jest używana tylko z metodą Set zasobu. Jeśli wartość jest identyfikatorem URI sieci Web, zasób pobiera pakiet do lokalnej pamięci podręcznej przed zainstalowaniem lub odinstalowaniem. Jeśli wartość jest ścieżką UNC, zasób instaluje dysk UNC przed zainstalowaniem lub odinstalowaniem.

Type: System.String

Właściwości opcjonalne

Argumenty

Określ dodatkowe argumenty, które mają być przekazywane do pakietu podczas instalacji lub odinstalowywania jako ciąg. Następujące argumenty są zawsze przekazywane:

  • Podczas instalowania /i <Path to the MSI package> jest pierwszym argumentem.
  • Podczas odinstalowywania /x <Product Entry Guid> jest pierwszym argumentem.
  • Jeśli parametr LogPath jest określony, zasób dołącza do listy argumentów /log "<LogPath>" . Aby uzyskać więcej informacji, zobacz LogPath .
  • /quiet i /norestart są zawsze dołączane.

Wartość tej właściwości jest dołączana po argumentach domyślnych.

Type: System.String
Default Value: None

Poświadczenie

W razie potrzeby określ poświadczenia konta z uprawnieniami do instalowania ścieżki UNC.

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

Zapewnienia

Określa, czy pakiet ma zostać zainstalowany, czy odinstalowany. Aby zainstalować pakiet, określ tę właściwość jako Present. Aby odinstalować pakiet, określ tę właściwość jako Absent. Wartość domyślna to Present.

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

Skrót pliku

Określ oczekiwaną wartość skrótu pliku MSI jako ciąg. Jeśli zostanie określony, zasób sprawdza pakiet względem tej wartości przed zainstalowaniem lub odinstalowaniem pakietu. Jeśli wartości nie są zgodne, zasób zgłasza nieprawidłowy wyjątek argumentu.

Type: System.String
Default Value: None

Algorytm

Określ algorytm używany do generowania wartości dla powłoki FileHash. Wartość domyślna to SHA256.

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

Ścieżka dziennika

Określ ścieżkę pliku do rejestrowania danych wyjściowych z wykonywania msi jako ciąg. Domyślnie dane wyjściowe nie są rejestrowane.

Type: System.String
Default Value: None

RunAsCredential

Określ poświadczenia alternatywnego konta, aby uruchomić instalację lub dezinstalację pakietu jako.

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

ServerCertificateValidationCallback

Określ blok skryptu programu PowerShell, aby zweryfikować certyfikaty SSL, gdy ścieżka jest identyfikatorem URI HTTPS. Jeśli blok skryptu nie zwróci $truewartości , metoda Set zasobu zgłasza nieprawidłowy wyjątek operacji i nie pobiera pakietu.

Type: System.String
Default Value: None

SignerSubject

Określ podmiot jako ciąg, który powinien być zgodny z certyfikatem podpisu cyfrowego pliku MSI. Jeśli zostanie określony, zasób sprawdza pakiet względem tej wartości przed zainstalowaniem lub odinstalowaniem pakietu. Jeśli wartości nie są zgodne, metoda Set zasobu zgłasza nieprawidłowy wyjątek argumentu.

Type: System.String
Default Value: None

SignerThumbprint

Określ odcisk palca certyfikatu jako ciąg, który powinien być zgodny z certyfikatem podpisu cyfrowego pliku MSI. Jeśli zostanie określony, zasób sprawdza pakiet względem tej wartości przed zainstalowaniem lub odinstalowaniem pakietu. Jeśli wartości nie są zgodne, metoda Set zasobu zgłasza nieprawidłowy wyjątek argumentu.

Type: System.String
Default Value: None

Właściwości tylko do odczytu

Zainstalowane

Data zainstalowania lub serwisowania pakietu MSI w zależności od tego, co nastąpi później. Nie można skonfigurować tej właściwości.

Type: System.String

InstallSource

Ścieżka do pakietu MSI.

Type: System.String

Nazwa

Nazwa wyświetlana pakietu MSI.

Type: System.String

PackageDescription

Opis pakietu MSI.

Type: System.String

Publisher

Wydawca pakietu MSI.

Type: System.String

Rozmiar

Rozmiar pakietu MSI w MB.

Type: System.UInt32

Wersja

Numer wersji pakietu MSI.

Type: System.String

Przykłady