MsiPackage

Cikk
05/05/2023

Áttekintés

MSI-csomag telepítése vagy eltávolítása.

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

Az MsiPackage erőforrás egy MSI-csomagot telepít vagy távolít el. A csomag lehet helyi, UNC meghajtón, vagy letölthető egy webes URI-ból. A csomagot másik fiókként is telepítheti. Szükség szerint további argumentumokat is megadhat a csomaghoz a telepítéshez vagy eltávolításhoz.

Követelmények

Nincsenek.

Fő tulajdonságok

ProductId

Adja meg a csomag sztringként való megkereséséhez használt azonosító számot. Ez az érték általában EGY GUID.

Type: System.String

Kötelező tulajdonságok

Elérési út

Adja meg az MSI-csomag elérési útját sztringként. Ennek a tulajdonságnak az értéke lehet a helyi gépen található MSI-fájl elérési útja, egy UNC-meghajtón található MSI-csomag elérési útja, vagy egy webes URI, ahonnan az MSI-csomag letölthető. Ha ennek a tulajdonságnak az értéke nem webes URI, akkor a végződésnek a végződésűnek .msikell lennie.

Ez a tulajdonság csak az erőforrás Set metódusával használható. Ha az érték egy webes URI, az erőforrás a telepítés vagy eltávolítás előtt letölti a csomagot egy helyi gyorsítótárba. Ha az érték UNC elérési út, az erőforrás a telepítés vagy eltávolítás előtt csatlakoztatja az UNC meghajtót.

Type: System.String

Választható tulajdonságok

Argumentumok

Adja meg a csomagnak a telepítés vagy az eltávolítás során sztringként továbbítandó további argumentumokat. A rendszer mindig a következő argumentumokat adja át:

Telepítéskor /i <Path to the MSI package> ez az első argumentum.
Eltávolításkor /x <Product Entry Guid> az első argumentum.
Ha a LogPath meg van adva, az erőforrás hozzáfűzi /log "<LogPath>" az argumentumlistához. További információt a LogPath webhelyen talál.
/quiet és /norestart mindig hozzáfűzve vannak.

A tulajdonság értéke az alapértelmezett argumentumok után lesz hozzáfűzve.

Type: System.String
Default Value: None

Hitelesítő adat

Adja meg egy fiók hitelesítő adatait, és szükség esetén csatlakoztassa az UNC elérési utat.

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

Biztosítja

Megadja, hogy telepíteni vagy eltávolítani szeretné-e a csomagot. A csomag telepítéséhez adja meg ezt a tulajdonságot a következőként Present: . A csomag eltávolításához adja meg ezt a tulajdonságot a következőként Absent: . Az alapértelmezett érték Present.

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

Fájlkivonat

Adja meg az MSI-fájl várt kivonatértékét sztringként. Ha meg van adva, az erőforrás ezt az értéket ellenőrzi a csomag telepítése vagy eltávolítása előtt. Ha az értékek nem egyeznek, az erőforrás érvénytelen argumentumkivételt jelez.

Type: System.String
Default Value: None

HashAlgorithm

Adja meg a FileHash értékének létrehozásához használt algoritmust. Az alapértelmezett érték SHA256.

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

LogPath

Adja meg a fájl elérési útját az MSI-végrehajtás kimenetének sztringként való naplózásához. Alapértelmezés szerint a kimenet nincs naplózva.

Type: System.String
Default Value: None

RunAsCredential

Adja meg egy másik fiók hitelesítő adatait a csomag telepítésének vagy eltávolításának futtatásához.

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

ServerCertificateValidationCallback

Adjon meg egy PowerShell-szkriptblokkot az SSL-tanúsítványok érvényesítéséhez, ha az elérési út HTTPS URI. Ha a szkriptblokk nem ad vissza $true, az erőforrás Set metódusa érvénytelen műveletkivételt jelez, és nem tölti le a csomagot.

Type: System.String
Default Value: None

SignerSubject

Adja meg a tárgyat sztringként, amely megfelel az MSI-fájl digitális aláírásának aláíró tanúsítványának. Ha meg van adva, az erőforrás ezt az értéket ellenőrzi a csomag telepítése vagy eltávolítása előtt. Ha az értékek nem egyeznek, az erőforrás Set metódusa érvénytelen argumentumkivételt eredményez.

Type: System.String
Default Value: None

SignerThumbprint

Adja meg a tanúsítvány ujjlenyomatát sztringként, amely megfelel az MSI-fájl digitális aláírásának aláíró tanúsítványának. Ha meg van adva, az erőforrás ezt az értéket ellenőrzi a csomag telepítése vagy eltávolítása előtt. Ha az értékek nem egyeznek, az erőforrás Set metódusa érvénytelen argumentumkivételt eredményez.

Type: System.String
Default Value: None

Csak olvasható tulajdonságok

InstalledOn

Az MSI-csomag telepítésének vagy szervizelésének dátuma, attól függően, hogy később van-e. Ez a tulajdonság nem konfigurálható.

Type: System.String

InstallSource

Az MSI-csomag elérési útja.

Type: System.String

Name

Az MSI-csomag megjelenítendő neve.

Type: System.String

PackageDescription

Az MSI-csomag leírása.

Type: System.String

Publisher

Az MSI-csomag közzétevője.

Type: System.String

Méret

Az MSI-csomag mérete MB-ban.

Type: System.UInt32

Verzió

Az MSI-csomag verziószáma.

Type: System.String