DSC-pakket resource

  • Artikel
  • 2 minuten om te lezen

Van toepassing op: Windows Power Shell 4,0, Windows Power shell 5. x

De pakket resource in Windows Power shell desired state Configuration (DSC) biedt een mechanisme voor het installeren of verwijderen van pakketten, zoals Windows Installer en setup.exe pakketten, op een doel knooppunt.

Notitie

Deze documentatie van deze DSC-resource bevat informatie over de versie die is opgenomen in PowerShell. De PSDscResources-module bevat nieuwe en bijgewerkte modules die officieel worden ondersteund door Microsoft. De PSDscResources-module is beschikbaar via de PowerShell Gallery.

Zie voor meer informatie en bijgewerkte documentatie het LEESMIJ in de GitHub opslagplaats.

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

Eigenschappen

Eigenschap Beschrijving
Naam Hiermee wordt de naam aangegeven van het pakket waarvoor u een specifieke status wilt controleren.
Pad Hiermee wordt het pad aangegeven waar het pakket zich bevindt.
ProductId Hiermee wordt de product-ID aangegeven waarmee het pakket uniek wordt geïdentificeerd.
Argumenten Een lijst met argumenten die precies zo worden door gegeven aan het pakket.
Referentie Biedt toegang tot het pakket op een externe bron. Deze eigenschap wordt niet gebruikt om het pakket te installeren. Het pakket wordt altijd op het lokale systeem geïnstalleerd.
Logboekpad Hiermee wordt het volledige pad aangegeven waar u wilt dat de provider een logboek bestand opslaat om het pakket te installeren of te verwijderen.
Return code Geeft de verwachte retour code aan. Als de daad werkelijke retour code niet overeenkomt met de verwachte waarde die hier wordt opgegeven, wordt er een fout geretourneerd door de configuratie.

Algemene eigenschappen

Eigenschap Beschrijving
DependsOn Geeft aan dat de configuratie van een andere bron moet worden uitgevoerd voordat deze resource wordt geconfigureerd. De syntaxis voor het gebruik van deze eigenschap is bijvoorbeeld als de ID van het resource-script blok dat u als eerste wilt uitvoeren, de naam ResourceName is en het type van de bron resource is DependsOn = "[ResourceType]ResourceName" .
Zo Hiermee wordt aangegeven of het pakket is geïnstalleerd. Stel deze eigenschap in op afwezig om te controleren of het pakket niet is geïnstalleerd (of verwijder het pakket als dit is geïnstalleerd). Stel deze in op aanwezig om te controleren of het pakket is geïnstalleerd. De standaard waarde is aanwezig .
PsDscRunAsCredential Hiermee stelt u de referentie in voor het uitvoeren van de gehele resource als.

Notitie

De algemene eigenschap PsDscRunAsCredential is toegevoegd aan WMF 5,0 om het uitvoeren van een DSC-resource in de context van andere referenties toe te staan. Zie referenties gebruiken met DSC-resourcesvoor meer informatie.

Voorbeeld

In dit voor beeld wordt het MSI-installatie programma uitgevoerd dat zich bevindt in het opgegeven pad en heeft de opgegeven 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"
    }
}