DSC PackageManagement-resurs

Gäller för: Windows PowerShell 4.0, Windows PowerShell 5.0 Windows PowerShell 5.1

PackageManagement-resursen i Windows PowerShell Desired State Configuration (DSC) tillhandahåller en mekanism för att installera eller avinstallera pakethantering på en målnod. Den här resursen kräver PackageManagement-modulen , som är tillgänglig från https://PowerShellGallery.com.

Viktigt

PackageManagement-modulen bör vara minst version 1.1.7.0 för att följande egenskapsinformation ska vara korrekt.

Anteckning

Den här dokumentationen för den här DSC-resursen omfattar den version som ingår i PowerShell före version 7.2. Modulen PSDscResources innehåller nya och uppdaterade DSC-resurser som stöds officiellt av Microsoft. Modulen PSDscResources är tillgänglig från PowerShell-galleriet.

Mer information och uppdaterad dokumentation finns i referensdokumentationen för PSDscResources.

Syntax

PackageManagement [string] #ResourceName
{
    Name = [string]
    [ AdditionalParameters = [HashTable] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string]{ Absent | Present } ]
    [ MaximumVersion = [string] ]
    [ MinimumVersion = [string] ]
    [ ProviderName = [string] ]
    [ PsDscRunAsCredential = [PSCredential] ]
    [ RequiredVersion = [string] ]
    [ Source = [string] ]
    [ SourceCredential = [PSCredential] ]
}

Egenskaper

Egenskap	Beskrivning
Name	Anger namnet på paketet som ska installeras eller avinstalleras.
Ytterligare parametrar	Providerspecifik hash-tabell med parametrar som skulle skickas till Get-Package -AdditionalArguments. För NuGet-providern kan du till exempel skicka ytterligare parametrar som Destination.
MaximumVersion	Anger den högsta tillåtna versionen av paketet som du vill hitta. Om du inte lägger till den här parametern hittar resursen den högsta tillgängliga versionen av paketet.
Minimumversion	Anger den lägsta tillåtna versionen av paketet som du vill hitta. Om du inte lägger till den här parametern hittar resursen den högsta tillgängliga versionen av paketet som också uppfyller den högsta angivna versionen som anges av parametern MaximumVersion .
ProviderName	Anger ett paketprovidernamn som paketsökningen ska begränsas till. Du kan hämta paketprovidernamn genom att köra cmdleten Get-PackageProvider .
RequiredVersion	Anger den exakta versionen av paketet som du vill installera. Om du inte anger den här parametern installerar den här DSC-resursen den senaste tillgängliga versionen av paketet som också uppfyller alla högsta versioner som anges av parametern MaximumVersion .
Källa	Anger namnet på den paketkälla där paketet finns. Detta kan antingen vara en URI eller en källa som registrerats med Register-PackageSource eller PackageManagementSource DSC-resursen.
SourceCredential	Anger ett användarkonto som har behörighet att installera ett paket för en angiven paketleverantör eller källa.

Ytterligare parametrar

I följande tabell visas alternativ för egenskapen AdditionalParameters.

Parameter	Beskrivning
Mål	Används av leverantörer som den inbyggda Nuget-providern. Anger en filplats där du vill att paketet ska installeras.
InstallationPolicy	Används av leverantörer som den inbyggda Nuget-providern. Avgör om du litar på paketets källa. Något av: Ej betrott eller betrott.

Gemensamma egenskaper

Egenskap	Beskrivning
DependsOn	Anger att konfigurationen av en annan resurs måste köras innan den här resursen har konfigurerats. Om till exempel ID:t för resurskonfigurationsskriptblocket som du vill köra först är ResourceName och dess typ är ResourceType är DependsOn = "[ResourceType]ResourceName"syntaxen för att använda den här egenskapen .
Säkerställa	Avgör om paketet ska installeras eller avinstalleras. Standardvärdet är Present.
PsDscRunAsCredential	Anger autentiseringsuppgifterna för att köra hela resursen som.

Anteckning

Den vanliga egenskapen PsDscRunAsCredential lades till i WMF 5.0 för att tillåta körning av valfri DSC-resurs i kontexten för andra autentiseringsuppgifter. Mer information finns i Använda autentiseringsuppgifter med DSC-resurser.

Exempel

Det här exemplet installerar JQuery NuGet-paketet och GistProvider PowerShell-modulen med hjälp av PackageManagement DSC-resursen. Det här exemplet säkerställer först att de nödvändiga paketkällorna är tillgängliga och definierar sedan det förväntade tillståndet för JQuery - och GistProvider-paketen (NuGet respektive PowerShell).

Configuration PackageTest
{
    Import-DscResource -ModuleName 'PackageManagement'

    PackageManagementSource SourceRepository
    {
        Ensure      = "Present"
        Name        = "MyNuget"
        ProviderName= "Nuget"
        SourceLocation   = "http://nuget.org/api/v2/"
        InstallationPolicy ="Trusted"
    }

    PackageManagementSource PSGallery
    {
        Ensure      = "Present"
        Name        = "psgallery"
        ProviderName= "PowerShellGet"
        SourceLocation   = "https://www.powershellgallery.com/api/v2"
        InstallationPolicy ="Trusted"
    }

    PackageManagement NugetPackage
    {
        Ensure               = "Present"
        Name                 = "JQuery"
        AdditionalParameters = "$env:HomeDrive\nuget"
        RequiredVersion      = "2.0.1"
        DependsOn            = "[PackageManagementSource]SourceRepository"
    }

    PackageManagement PSModule
    {
        Ensure               = "Present"
        Name                 = "gistprovider"
        Source               = "PSGallery"
        DependsOn            = "[PackageManagementSource]PSGallery"
    }
}