MsiPackage

Article
05/05/2023

Synopsis

Installez ou désinstallez un package MSI.

Syntaxe

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

La MsiPackage ressource installe ou désinstalle un package MSI. Le package peut être local, sur un lecteur UNC ou téléchargé à partir d’un URI web. Vous pouvez installer le package en tant que compte secondaire. Vous pouvez spécifier des arguments supplémentaires pour l’installation ou la désinstallation du package en fonction des besoins.

Configuration requise

Aucun.

Propriétés de la clé

ProductId

Spécifiez le numéro d’identification utilisé pour rechercher le package sous forme de chaîne. Cette valeur est généralement un GUID.

Type: System.String

Propriétés obligatoires

Chemin d’accès

Spécifiez le chemin d’accès au package MSI sous forme de chaîne. La valeur de cette propriété peut être le chemin d’accès à un fichier MSI sur l’ordinateur local, le chemin d’accès à un package MSI sur un lecteur UNC ou un URI web à partir duquel le package MSI peut être téléchargé. Si la valeur de cette propriété n’est pas un URI web, elle doit se terminer par .msi.

Cette propriété est utilisée uniquement avec la méthode Set de la ressource. Si la valeur est un URI web, la ressource télécharge le package dans un cache local avant d’installer ou de désinstaller le package. Si la valeur est un chemin UNC, la ressource monte le lecteur UNC avant d’installer ou de désinstaller.

Type: System.String

Propriétés facultatives

Arguments

Spécifiez les arguments supplémentaires à transmettre au package pendant l’installation ou la désinstallation sous forme de chaîne. Les arguments suivants sont toujours passés :

Lors de l’installation, /i <Path to the MSI package> est le premier argument.
Lors de la désinstallation, /x <Product Entry Guid> est le premier argument.
Si LogPath est spécifié, la ressource est ajoutée à la liste d’arguments /log "<LogPath>" . Pour plus d’informations, consultez LogPath .
/quiet et /norestart sont toujours ajoutés.

La valeur de cette propriété est ajoutée après les arguments par défaut.

Type: System.String
Default Value: None

Informations d'identification

Spécifiez les informations d’identification d’un compte avec l’autorisation de monter un chemin UNC si nécessaire.

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

Ensure

Spécifie s’il faut installer ou désinstaller le package. Pour installer le package, spécifiez cette propriété en tant que Present. Pour désinstaller le package, spécifiez cette propriété en tant que Absent. La valeur par défaut est Present.

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

FileHash

Spécifiez la valeur de hachage attendue du fichier MSI en tant que chaîne. Si elle est spécifiée, la ressource vérifie le package par rapport à cette valeur avant d’installer ou de désinstaller le package. Si les valeurs ne correspondent pas, la ressource lève une exception d’argument non valide.

Type: System.String
Default Value: None

HashAlgorithm

Spécifiez l’algorithme utilisé pour générer la valeur de FileHash. La valeur par défaut est SHA256.

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

LogPath

Spécifiez le chemin d’accès d’un fichier pour enregistrer la sortie de l’exécution MSI en tant que chaîne. Par défaut, la sortie n’est pas journalisée.

Type: System.String
Default Value: None

RunAsCredential

Spécifiez les informations d’identification d’un autre compte pour exécuter l’installation ou la désinstallation du package en tant que.

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

ServerCertificateValidationCallback

Spécifiez un scriptBlock PowerShell pour valider les certificats SSL quand Path est un URI HTTPS. Si le scriptblock ne retourne $truepas, la méthode Set de la ressource lève une exception d’opération non valide et ne télécharge pas le package.

Type: System.String
Default Value: None

SignerSubject

Spécifiez l’objet sous la forme d’une chaîne qui doit correspondre au certificat du signataire de la signature numérique du fichier MSI. Si elle est spécifiée, la ressource vérifie le package par rapport à cette valeur avant d’installer ou de désinstaller le package. Si les valeurs ne correspondent pas, la méthode Set de la ressource lève une exception d’argument non valide.

Type: System.String
Default Value: None

SignerThumbprint

Spécifiez l’empreinte numérique du certificat sous la forme d’une chaîne qui doit correspondre au certificat de signataire de la signature numérique du fichier MSI. Si elle est spécifiée, la ressource vérifie le package par rapport à cette valeur avant d’installer ou de désinstaller le package. Si les valeurs ne correspondent pas, la méthode Set de la ressource lève une exception d’argument non valide.

Type: System.String
Default Value: None

Propriétés en lecture seule

InstalledOn

Date d’installation ou de service du package MSI, selon la date à laquelle le package MSI a été installé. Cette propriété n’est pas configurable.

Type: System.String

InstallSource

Chemin d’accès au package MSI.

Type: System.String

Nom

Nom complet du package MSI.

Type: System.String

PackageDescription

Description du package MSI.

Type: System.String

Publisher

Éditeur du package MSI.

Type: System.String

Taille

Taille du package MSI en Mo.

Type: System.UInt32

Version

Numéro de version du package MSI.

Type: System.String

Partager via