Compartir a través de

MsiPackage

  • Artículo

Sinopsis

Instale o desinstale un paquete MSI.

Sintaxis

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

Descripción

El MsiPackage recurso instala o desinstala un paquete MSI. El paquete puede ser local, en una unidad UNC o descargarse desde un URI web. Puede instalar el paquete como una cuenta alternativa. Puede especificar argumentos adicionales en el paquete para la instalación o desinstalación según sea necesario.

Requisitos

Ninguno.

Propiedades de la clave

ProductId

Especifique el número de identificación usado para buscar el paquete como una cadena. Este valor suele ser un GUID.

Type: System.String

Propiedades obligatorias

Ruta de acceso

Especifique la ruta de acceso al paquete MSI como una cadena. El valor de esta propiedad puede ser la ruta de acceso a un archivo MSI en el equipo local, la ruta de acceso a un paquete MSI en una unidad UNC o un URI web desde el que se puede descargar el paquete MSI. Si el valor de esta propiedad no es un URI web, debe terminar con .msi.

Esta propiedad solo se usa con el método Set del recurso. Si el valor es un URI web, el recurso descarga el paquete en una caché local antes de instalar o desinstalar. Si el valor es una ruta de acceso UNC, el recurso monta la unidad UNC antes de instalar o desinstalar.

Type: System.String

Propiedades opcionales

Argumentos

Especifique los argumentos adicionales que se van a pasar al paquete durante la instalación o desinstalación como una cadena. Siempre se pasan los argumentos siguientes:

  • Al instalar, /i <Path to the MSI package> es el primer argumento.
  • Al desinstalar, /x <Product Entry Guid> es el primer argumento.
  • Si se especifica LogPath , el recurso se anexa a la lista de argumentos /log "<LogPath>" . Consulte LogPath para obtener más información.
  • /quiet y /norestart siempre se anexan.

El valor de esta propiedad se anexa después de los argumentos predeterminados.

Type: System.String
Default Value: None

Credential:

Especifique la credencial de una cuenta con permiso para montar una ruta de acceso UNC si es necesario.

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

Ensure

Especifica si se va a instalar o desinstalar el paquete. Para instalar el paquete, especifique esta propiedad como Present. Para desinstalar el paquete, especifique esta propiedad como Absent. El valor predeterminado es Present.

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

FileHash

Especifique el valor hash esperado del archivo MSI como una cadena. Si se especifica, el recurso comprueba el paquete con este valor antes de instalar o desinstalar el paquete. Si los valores no coinciden, el recurso produce una excepción de argumento no válida.

Type: System.String
Default Value: None

HashAlgorithm

Especifique el algoritmo usado para generar el valor de FileHash. El valor predeterminado es SHA256.

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

LogPath

Especifique la ruta de acceso a un archivo para registrar la salida de la ejecución de MSI como una cadena. De forma predeterminada, la salida no se registra.

Type: System.String
Default Value: None

RunAsCredential

Especifique la credencial de una cuenta alternativa para ejecutar la instalación o desinstalación del paquete como.

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

ServerCertificateValidationCallback

Especifique un bloque de scripts de PowerShell para validar los certificados SSL cuando Path es un URI HTTPS. Si el scriptblock no devuelve $true, el método Set del recurso produce una excepción de operación no válida y no descarga el paquete.

Type: System.String
Default Value: None

SignerSubject

Especifique el asunto como una cadena que debe coincidir con el certificado del firmante de la firma digital del archivo MSI. Si se especifica, el recurso comprueba el paquete con este valor antes de instalar o desinstalar el paquete. Si los valores no coinciden, el método Set del recurso produce una excepción de argumento no válida.

Type: System.String
Default Value: None

SignerThumbprint

Especifique la huella digital del certificado como una cadena que debe coincidir con el certificado del firmante de la firma digital del archivo MSI. Si se especifica, el recurso comprueba el paquete con este valor antes de instalar o desinstalar el paquete. Si los valores no coinciden, el método Set del recurso produce una excepción de argumento no válida.

Type: System.String
Default Value: None

Propiedades de solo lectura

InstalledOn

Fecha en la que se instaló el paquete MSI en o en el que se ha realizado el servicio, lo que sea posterior. Esta propiedad no es configurable.

Type: System.String

InstallSource

Ruta de acceso al paquete MSI.

Type: System.String

Nombre

Nombre para mostrar del paquete MSI.

Type: System.String

PackageDescription

Descripción del paquete MSI.

Type: System.String

Publicador

Publicador del paquete MSI.

Type: System.String

Size

Tamaño del paquete MSI en MB.

Type: System.UInt32

Versión

Número de versión del paquete MSI.

Type: System.String

Ejemplos