Recurso de DSC WindowsPackageCabDSC WindowsPackageCab Resource

Aplica-se a: Windows PowerShell 5.1 e posteriorApplies To: Windows PowerShell 5.1 and later

O WindowsPackageCab no DSC (Desired State Configuration) do Windows PowerShell fornece um mecanismo para instalar ou desinstalar pacotes de gabinete (.cab) do Windows em um nó de destino.The WindowsPackageCab resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to install or uninstall Windows cabinet (.cab) packages on a target node.

O nó de destino deve ter o módulo PowerShell do DISM instalado.The target node must have the DISM PowerShell module installed. Para obter informações, consulte Usar DISM no Windows PowerShell.For information, see Use DISM in Windows PowerShell.

SintaxeSyntax

{
    Name = [string]
    Ensure = [string] { Absent | Present }
    SourcePath = [string]
    [ LogPath = [string] ]
    [ DependsOn = [string[]] ]
}

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 you want to ensure a specific state.
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.
CaminhoPath Indica o caminho em que o pacote reside.Indicates the path where the package resides.
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"`.

ExemploExample

A configuração de exemplo a seguir usa parâmetros de entrada e garante que o arquivo .cab especificado pelo parâmetro $Name esteja instalado.The following example configuration takes input parameters, and ensures that the .cab file specified by the $Name parameter is installed.

Configuration Sample_WindowsPackageCab
{
    param
    (
        [Parameter (Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [String]
        $Name,

        [Parameter (Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [String]
        $SourcePath,

        [Parameter(Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [String]
        $LogPath
    )

    Import-DscResource -ModuleName 'PSDscResources'

    WindowsPackageCab WindowsPackageCab1
    {
        Name = $Name
        Ensure = 'Present'
        SourcePath = $SourcePath
        LogPath = $LogPath
    }
}