MsiPackage

  • Artigo

Sinopse

Instalar ou desinstalar um pacote MSI.

Sintaxe

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

Descrição

O MsiPackage recurso instala ou desinstala um pacote MSI. O pacote pode ser local, em uma unidade UNC ou baixado de um URI web. Você pode instalar o pacote como uma conta alternativa. Você pode especificar argumentos adicionais para o pacote para instalação ou desinstalação, conforme necessário.

Requisitos

Nenhum.

Propriedades da chave

ProductId

Especifique o número de identificação usado para localizar o pacote como uma cadeia de caracteres. Esse valor geralmente é um GUID.

Type: System.String

Propriedades obrigatórias

Caminho

Especifique o caminho para o pacote MSI como uma cadeia de caracteres. O valor dessa propriedade pode ser o caminho para um arquivo MSI no computador local, o caminho para um pacote MSI em uma unidade UNC ou um URI Web do qual o pacote MSI pode ser baixado. Se o valor dessa propriedade não for um URI da Web, ele deverá terminar com .msi.

Essa propriedade só é usada com o método Set do recurso. Se o valor for um URI da Web, o recurso baixará o pacote para um cache local antes de instalar ou desinstalar. Se o valor for um caminho UNC, o recurso montará a unidade UNC antes de instalar ou desinstalar.

Type: System.String

Propriedades opcionais

Argumentos

Especifique os argumentos adicionais a serem passados para o pacote durante a instalação ou a desinstalação como uma cadeia de caracteres. Os seguintes argumentos sempre são passados:

  • Ao instalar, /i <Path to the MSI package> é o primeiro argumento.
  • Ao desinstalar, /x <Product Entry Guid> é o primeiro argumento.
  • Se o LogPath for especificado, o recurso será acrescentado /log "<LogPath>" à lista de argumentos. Consulte LogPath para obter mais informações.
  • /quiet e /norestart são sempre acrescentados.

O valor dessa propriedade é acrescentado após os argumentos padrão.

Type: System.String
Default Value: None

Credencial

Especifique a credencial de uma conta com permissão para montar um caminho UNC, se necessário.

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

Ensure

Especifica se o pacote deve ser instalado ou desinstalado. Para instalar o pacote, especifique essa propriedade como Present. Para desinstalar o pacote, especifique essa propriedade como Absent. O valor padrão é Present.

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

FileHash

Especifique o valor de hash esperado do arquivo MSI como uma cadeia de caracteres. Se especificado, o recurso verifica o pacote em relação a esse valor antes de instalar ou desinstalar o pacote. Se os valores não corresponderem, o recurso gerará uma exceção de argumento inválida.

Type: System.String
Default Value: None

Hashalgorithm

Especifique o algoritmo usado para gerar o valor para FileHash. O valor padrão é SHA256.

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

LogPath

Especifique o caminho de um arquivo para registrar a saída da execução do MSI como uma cadeia de caracteres. Por padrão, a saída não é registrada.

Type: System.String
Default Value: None

RunAsCredential

Especifique a credencial de uma conta alternativa para executar a instalação ou desinstalação do pacote como.

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

Servercertificatevalidationcallback

Especifique um scriptblock do PowerShell para validar certificados SSL quando o Path for um URI HTTPS. Se o scriptblock não retornar $true, o método Set do recurso lançará uma exceção de operação inválida e não baixará o pacote.

Type: System.String
Default Value: None

SignerSubject

Especifique o assunto como uma cadeia de caracteres que deve corresponder ao certificado de signatário da assinatura digital do arquivo MSI. Se especificado, o recurso verifica o pacote em relação a esse valor antes de instalar ou desinstalar o pacote. Se os valores não corresponderem, o método Set do recurso gerará uma exceção de argumento inválida.

Type: System.String
Default Value: None

SignerThumbprint

Especifique a impressão digital do certificado como uma cadeia de caracteres que deve corresponder ao certificado de signatário da assinatura digital do arquivo MSI. Se especificado, o recurso verifica o pacote em relação a esse valor antes de instalar ou desinstalar o pacote. Se os valores não corresponderem, o método Set do recurso gerará uma exceção de argumento inválida.

Type: System.String
Default Value: None

Propriedades somente leitura

InstalledOn

A data em que o pacote MSI foi instalado ou atendido, o que for posterior. Essa propriedade não é configurável.

Type: System.String

InstallSource

O caminho para o pacote MSI.

Type: System.String

Nome

O nome de exibição do pacote MSI.

Type: System.String

PackageDescription

A descrição do pacote MSI.

Type: System.String

Publisher

O editor do pacote MSI.

Type: System.String

Tamanho

O tamanho do pacote MSI em MB.

Type: System.UInt32

Versão

O número de versão do pacote MSI.

Type: System.String

Exemplos