Prostředek balíčku DSC

Platí pro: Windows PowerShell 4.0, Windows PowerShell 5.x

Prostředek Package v Windows PowerShell Desired State Configuration (DSC) poskytuje mechanismus pro instalaci nebo odinstalaci balíčků, jako jsou instalační služba systému Windows a balíčky setup.exe, na cílovém uzlu.

Poznámka

Tato dokumentace k tomuto prostředku DSC se zabývá verzí, která je součástí PowerShellu před verzí 7.2. Modul PSDscResources obsahuje nové a aktualizované prostředky DSC, které jsou oficiálně podporovány Microsoftem. Modul PSDscResources je k dispozici v Galerie prostředí PowerShell.

Další informace a aktualizovanou dokumentaci najdete v referenční dokumentaci k 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] ]
}

Vlastnosti

Vlastnost	Popis
Název	Určuje název balíčku, pro který chcete zajistit konkrétní stav.
Cesta	Označuje cestu, kde se nachází balíček.
ProductId	Označuje ID produktu, které jednoznačně identifikuje balíček.
Argumenty	Vypíše řetězec argumentů, který se předá balíčku přesně tak, jak je zadaný.
Přihlašovací údaj	Poskytuje přístup k balíčku na vzdáleném zdroji. Tato vlastnost se nepoužívá k instalaci balíčku. Balíček je vždy nainstalován v místním systému.
Cesta protokolu	Označuje úplnou cestu, kam má poskytovatel uložit soubor protokolu pro instalaci nebo odinstalaci balíčku.
Kód návratu	Označuje očekávaný návratový kód. Pokud skutečný návratový kód neodpovídá zde uvedené očekávané hodnotě, vrátí konfigurace chybu.

Společné vlastnosti

Vlastnost	Popis
DependsOn	Označuje, že konfigurace jiného prostředku musí být spuštěna před konfigurací tohoto prostředku. Pokud je například ID bloku konfiguračního skriptu prostředku, který chcete spustit jako první, ResourceName a jeho typ je ResourceType, syntaxe pro použití této vlastnosti je DependsOn = "[ResourceType]ResourceName".
Zajištění	Označuje, jestli je balíček nainstalovaný. Nastavte tuto vlastnost na Chybějící , aby se zajistilo, že balíček není nainstalovaný (nebo balíček odinstalujte, pokud je nainstalovaný). Nastavte ho na Prezentovat , aby se zajistilo, že je balíček nainstalovaný. Výchozí hodnota je Present (Prezentovat).
PsDscRunAsCredential	Nastaví přihlašovací údaje pro spuštění celého prostředku jako.

Poznámka

Společná vlastnost PsDscRunAsCredential byla přidána do WMF 5.0, aby bylo možné spustit jakýkoli prostředek DSC v kontextu jiných přihlašovacích údajů. Další informace najdete v tématu Použití přihlašovacích údajů s prostředky DSC.

Příklad

Tento příklad spustí instalační program .msi, který se nachází v zadané cestě a má zadané ID produktu.

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