DSC-pakketresource

Van toepassing op: Windows PowerShell 4.0, Windows PowerShell 5.x

De pakketresource in Windows PowerShell Desired State Configuration (DSC) biedt een mechanisme voor het installeren of verwijderen van pakketten, zoals Windows Installer en setup.exe-pakketten, op een doelknooppunt.

Notitie

Deze documentatie van deze DSC-resource heeft betrekking op de versie die is opgenomen in PowerShell vóór versie 7.2. De PSDscResources-module bevat nieuwe en bijgewerkte DSC-resources die officieel worden ondersteund door Microsoft. De PSDscResources-module is beschikbaar via de PowerShell Gallery.

Zie de psdscResources-referentiedocumentatie voor meer informatie en bijgewerkte documentatie.

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	Geeft de naam aan van het pakket waarvoor u een specifieke status wilt garanderen.
Pad	Geeft het pad aan waar het pakket zich bevindt.
ProductId	Geeft de product-id aan die het pakket uniek identificeert.
Argumenten	Hiermee wordt een reeks argumenten weergegeven die exact op de opgegeven wijze aan het pakket worden doorgegeven.
Referentie	Biedt toegang tot het pakket op een externe bron. Deze eigenschap wordt niet gebruikt om het pakket te installeren. Het pakket wordt altijd geïnstalleerd op het lokale systeem.
Logboekpad	Geeft het volledige pad aan waar de provider een logboekbestand moet opslaan om het pakket te installeren of te verwijderen.
Retourcode	Geeft de verwachte retourcode aan. Als de werkelijke retourcode niet overeenkomt met de verwachte waarde die hier wordt opgegeven, retourneert de configuratie een fout.

Algemene eigenschappen

Eigenschap	Beschrijving
Afhankelijk van	Geeft aan dat de configuratie van een andere resource moet worden uitgevoerd voordat deze resource wordt geconfigureerd. Als de id van het resourceconfiguratiescriptblok dat u eerst wilt uitvoeren bijvoorbeeld ResourceName is en het type ResourceType is, is DependsOn = "[ResourceType]ResourceName"de syntaxis voor het gebruik van deze eigenschap .
Verifiëren	Geeft aan of het pakket is geïnstalleerd. Stel deze eigenschap in op Afwezig om ervoor te zorgen dat het pakket niet is geïnstalleerd (of verwijder het pakket als het is geïnstalleerd). Stel deze in op Presenteren om ervoor te zorgen dat het pakket is geïnstalleerd. De standaardwaarde is Aanwezig.
PsDscRunAsCredential	Hiermee stelt u de referentie voor het uitvoeren van de hele resource als in.

Notitie

De algemene eigenschap PsDscRunAsCredential is toegevoegd in WMF 5.0 om het uitvoeren van een DSC-resource in de context van andere referenties toe te staan. Zie Referenties gebruiken met DSC-resources voor meer informatie.

Voorbeeld

In dit voorbeeld wordt het .msi-installatieprogramma uitgevoerd dat zich op het opgegeven pad bevindt en de opgegeven product-id heeft.

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