DSC-Package Management-ResourceDSC PackageManagement Resource

Van toepassing op: Windows PowerShell 4.0, Windows PowerShell 5.0 en Windows PowerShell 5.1Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0, Windows PowerShell 5.1

De PackageManagement resource in Windows PowerShell Desired State Configuration (DSC) biedt een mechanisme om te installeren of verwijderen van Package Management-pakketten op een doelknooppunt.The PackageManagement resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to install or uninstall Package Management packages on a target node. Deze resource is vereist de PackageManagement -module, beschikbaar is via http://PowerShellGallery.com .This resource requires the PackageManagement module, available from http://PowerShellGallery.com.

Belangrijk

De PackageManagement module moet ten minste versie 1.1.7.0 voor de volgende eigenschapsinformatie juist te zijn.The PackageManagement module should be at least version 1.1.7.0 for the following property information to be correct.

SyntaxisSyntax

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

EigenschappenProperties

EigenschapProperty BeschrijvingDescription
NaamName Hiermee geeft u de naam van het pakket dat moet worden geïnstalleerd of verwijderd.Specifies the name of the Package to be installed or uninstalled.
AdditionalParametersAdditionalParameters Specifieke hashtabel van de provider van de parameters die worden doorgegeven aan Get-Package -AdditionalArguments.Provider specific hashtable of parameters that would be passed to Get-Package -AdditionalArguments. Bijvoorbeeld, kunt u aanvullende parameters, zoals het doelpad doorgeven voor NuGet-provider.For example, for NuGet provider you can pass additional parameters like DestinationPath.
Zorg ervoor datEnsure Bepaalt of het pakket moet worden geïnstalleerd of verwijderd.Determines whether the package is to be installed or uninstalled.
MaximumVersionMaximumVersion Hiermee geeft u de maximaal toegestane versie van het pakket dat u wilt zoeken.Specifies the maximum allowed version of the package that you want to find. Als u deze parameter niet toevoegt, zoekt de resource is de hoogste versie van het pakket.If you do not add this parameter, the resource finds the highest available version of the package.
MinimumVersionMinimumVersion Hiermee geeft u de minimaal toegestane versie van het pakket dat u wilt zoeken.Specifies the minimum allowed version of the package that you want to find. Als u deze parameter niet toevoegt, de bron zoekt naar de hoogste versie van het pakket dat ook voldoet aan alle maximale opgegeven versie van het opgegeven door de MaximumVersion parameter.If you do not add this parameter, the resource finds the highest available version of the package that also satisfies any maximum specified version specified by the MaximumVersion parameter.
ProviderNameProviderName Hiermee geeft u de naam van een pakket provider waarnaar u wilt uw zoekopdracht pakket beperken.Specifies a package provider name to which to scope your package search. Krijgt u provider-pakketnamen door het uitvoeren van de Get-PackageProvider cmdlet.You can get package provider names by running the Get-PackageProvider cmdlet.
RequiredVersionRequiredVersion Hiermee geeft u de exacte versie van het pakket dat u wilt installeren.Specifies the exact version of the package that you want to install. Als u deze parameter niet opgeeft, deze DSC-resource wordt geïnstalleerd voor de nieuwste beschikbare versie van het pakket dat ook voldoet aan een maximale versie van het opgegeven door de MaximumVersion parameter.If you do not specify this parameter, this DSC resource installs the newest available version of the package that also satisfies any maximum version specified by the MaximumVersion parameter.
BronSource Hiermee geeft u de naam van de pakketbron waar het pakket kan worden gevonden.Specifies the name of the package source where the package can be found. Dit kan een URI of een bron die is geregistreerd bij Register-PackageSource of PackageManagementSource DSC-resource.This can either be a URI or a source registered with Register-PackageSource or PackageManagementSource DSC resource.
SourceCredentialSourceCredential Hiermee geeft u een gebruikersaccount met rechten voor het installeren van een pakket voor een opgegeven pakket-provider of de bron.Specifies a user account that has rights to install a package for a specified package provider or source.

Extra ParametersAdditional Parameters

De volgende tabel bevat opties voor de eigenschap AdditionalParameters.The following table lists options for the AdditionalParameters property.

ParameterParameter BeschrijvingDescription
DestinationPathDestinationPath Gebruikt door providers, zoals de geïntegreerde Nuget-Provider.Used by providers such as the built-in Nuget Provider. Hiermee geeft u een locatie waar u het pakket dat moet worden geïnstalleerd.Specifies a file location where you want the package to be installed.
InstallationPolicyInstallationPolicy Gebruikt door providers, zoals de geïntegreerde Nuget-Provider.Used by providers such as the built-in Nuget Provider. Hiermee bepaalt u of u het pakket met de bron vertrouwt.Determines whether you trust the package's source. Een van: Untrusted, Trusted.One of: Untrusted, Trusted.

VoorbeeldExample

In dit voorbeeld installeert de JQuery NuGet-pakket en GistProvider PowerShell module met behulp van de PackageManagement DSC-resource.This example installs the JQuery NuGet package and GistProvider PowerShell module using the PackageManagement DSC resource. In dit voorbeeld eerst zorgt ervoor dat de bronnen vereist pakket beschikbaar zijn en vervolgens definieert de verwachte status van de JQuery en GistProvider pakketten (NuGet en PowerShell, respectievelijk).This example first ensures the required package sources are available then defines the expected state of the JQuery and GistProvider packages (NuGet and PowerShell, respectively).

Configuration PackageTest
{
    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"
    }
}