Recurso Package de DSCDSC Package Resource

Aplica-se a: Windows PowerShell 4.0, Windows PowerShell 5.0Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0

O recurso Package na Configuração de Estado Desejado (DSC) do Windows PowerShell fornece um mecanismo para instalar ou desinstalar pacotes, tais como os pacotes do Windows Installer e setup.exe, em um nó de destino.The Package resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to install or uninstall packages, such as Windows Installer and setup.exe packages, on a target node.

SintaxeSyntax

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

PropriedadesProperties

PropriedadeProperty DescriçãoDescription
NomeName Indica o nome do pacote para o qual você deseja garantir um estado específico.Indicates the name of the package for which you want to ensure a specific state.
CaminhoPath Indica o caminho em que o pacote reside.Indicates the path where the package resides.
ProductIdProductId Indica a ID do produto que identifica o pacote com exclusividade.Indicates the product ID that uniquely identifies the package.
ArgumentosArguments Lista uma cadeia de caracteres de argumentos que será passada para o pacote exatamente conforme fornecido.Lists a string of arguments that will be passed to the package exactly as provided.
CredentialCredential Fornece acesso ao pacote em uma fonte remota.Provides access to the package on a remote source. Essa propriedade não é usada para instalar o pacote.This property is not used to install the package. O pacote é sempre instalado no sistema local.The package is always installed on the local system.
EnsureEnsure Indica se o pacote foi instalado.Indicates if the package is installed. Defina esta propriedade como "Absent" para garantir que o pacote não seja instalado (ou desinstalar o pacote, se ele estiver instalado).Set this property to "Absent" to ensure the package is not installed (or uninstall the package if it is installed). Defina-a como "Present" (o valor padrão) para garantir que o pacote seja instalado.Set it to "Present" (the default value) to ensure the package is installed.
LogPathLogPath Indica o caminho completo em que você deseja que o provedor salve um arquivo de log para instalar ou desinstalar o pacote.Indicates the full path where you want the provider to save a log file to install or uninstall the package.
DependsOnDependsOn Indica que a configuração de outro recurso deve ser executada antes de ele ser configurado.Indicates that the configuration of another resource must run before this resource is configured. Por exemplo, se a ID do bloco de script de configuração do recurso que você deseja executar primeiro for ResourceName e seu tipo for ResourceType, a sintaxe para usar essa propriedade será DependsOn = "[ResourceType]ResourceName"`.For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName"`.
ReturnCodeReturnCode Indica o código de retorno esperado.Indicates the expected return code. Se o código de retorno real não corresponder ao valor esperado fornecido aqui, a configuração gerará um erro.If the actual return code does not match the expected value provided here, the configuration will return an error.

ExemploExample

Este exemplo executa o instalador .msi que está localizado no caminho especificado e tem a ID do produto especificado.This example runs the .msi installer that is located at the specified path and has the specified product ID.

Configuration PackageTest
{
    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"
    } 
}