MsiPackage
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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de