Recurso do Pacote DSC

Aplica-se a: Windows PowerShell 4.0, Windows PowerShell 5.x

O recurso Pacote no Windows PowerShell Desired State Configuration (DSC) fornece um mecanismo para instalar ou desinstalar pacotes, como o Windows Installer e pacotes de setup.exe, num nó de destino.

Nota

Esta documentação deste recurso do DSC abrange a versão incluída no PowerShell anterior à versão 7.2. O módulo PSDscResources contém recursos DSC novos e atualizados que são oficialmente suportados pela Microsoft. O módulo PSDscResources está disponível no Galeria do PowerShell.

Para obter mais informações e documentação atualizada, veja a documentação de referência PSDscResources.

Syntax

Package [string] #ResourceName
{
    Name = [string]
    Path = [string]
    ProductId = [string]
    [ Arguments = [string] ]
    [ Credential = [PSCredential] ]
    [ LogPath = [string] ]
    [ ReturnCode = [UInt32[]] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Propriedades

Propriedade	Descrição
Nome	Indica o nome do pacote para o qual pretende garantir um estado específico.
Caminho	Indica o caminho onde o pacote reside.
ProductId	Indica o ID do produto que identifica exclusivamente o pacote.
Argumentos	Lista uma cadeia de argumentos que serão transmitidos para o pacote exatamente conforme fornecido.
Credencial	Fornece acesso ao pacote numa origem remota. Esta propriedade não é utilizada para instalar o pacote. O pacote é sempre instalado no sistema local.
LogPath	Indica o caminho completo onde pretende que o fornecedor guarde um ficheiro de registo para instalar ou desinstalar o pacote.
ReturnCode	Indica o código de retorno esperado. Se o código de retorno real não corresponder ao valor esperado aqui fornecido, a configuração devolverá um erro.

Common properties (Propriedades comuns)

Propriedade	Descrição
DependsOn	Indica que a configuração de outro recurso tem de ser executada antes de este recurso ser configurado. Por exemplo, se o ID do bloco de script de configuração de recursos que pretende executar primeiro for ResourceName e o respetivo tipo for ResourceType, a sintaxe para utilizar esta propriedade é DependsOn = "[ResourceType]ResourceName".
Certifique-se de que	Indica se o pacote está instalado. Defina esta propriedade como Ausente para garantir que o pacote não está instalado (ou desinstale o pacote se estiver instalado). Defina-o como Apresentar para garantir que o pacote está instalado. O valor predefinido é Presente.
PsDscRunAsCredential	Define a credencial para executar todo o recurso como.

Nota

A propriedade comum PsDscRunAsCredential foi adicionada no WMF 5.0 para permitir a execução de qualquer recurso DSC no contexto de outras credenciais. Para obter mais informações, veja Utilizar Credenciais com Recursos do DSC.

Exemplo

Este exemplo executa o instalador .msi localizado no caminho especificado e tem o ID de produto especificado.

Configuration PackageTest
{
    Import-DscResource -ModuleName 'PSDesiredStateConfiguration'

    Package PackageExample
    {
        Ensure      = "Present"  # You can also set Ensure to "Absent"
        Path        = "$Env:SystemDrive\TestFolder\TestProject.msi"
        Name        = "TestPackage"
        ProductId   = "ACDDCDAF-80C6-41E6-A1B9-8ABD8A05027E"
    }
}