DSC-PackageManagement ResourceDSC PackageManagement Resource

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

De PackageManagement in Windows PowerShell Desired State Configuration (DSC)-bron biedt een mechanisme om te installeren of verwijderen van pakketten in een doelknooppunt Package Management.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 vereist de PackageManagement module beschikbaar is via http://PowerShellGallery.com.This resource requires the PackageManagement module, available from http://PowerShellGallery.com.

SyntaxisSyntax

PackageManagement [string] #ResourceName
{
    Name = [string]
    [ Source = [string] ]
    [ Ensure = [string] { Absent | Present }  ]
    [ RequiredVersion = [string] ]
    [ MinimumVersion = [string] ]
    [ MaximumVersion = [string] ]
    [ SourceCredential = [PSCredential] ]
    [ ProviderName = [string] ]
    [ AdditionalParameters = [Microsoft.Management.Infrastructure.CimInstance[]] ]
}

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.
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 registreren PackageSource of PackageManagementSource DSC-resource.This can either be a URI or a source registered with Register-PackageSource or PackageManagementSource DSC resource. De DSC-resource MSFT_PackageManagementSource kunt ook een pakketbron registreren.The DSC resource MSFT_PackageManagementSource can also register a package source.
Zorg ervoor datEnsure Bepaalt of het pakket moet worden geïnstalleerd of verwijderd.Determines whether the package is to be installed or uninstalled.
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, wordt de nieuwste versie van het pakket dat ook voldoet aan alle maximale versie van het opgegeven met de parameter MaximumVersion geïnstalleerd in deze DSC-resource.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.
MinimumVersionMinimumVersion Hiermee geeft u de minimaal toegestane versie van het pakket dat u wilt installeren.Specifies the minimum allowed version of the package that you want to install. Als u deze parameter niet toevoegt, wordt deze DSC-resource intalls de hoogste versie van het pakket dat ook voldoet aan alle maximale versie van het opgegeven opgegeven door de parameter MaximumVersion.If you do not add this parameter, this DSC resource intalls the highest available version of the package that also satisfies any maximum specified version specified by the MaximumVersion parameter.
MaximumVersionMaximumVersion Hiermee geeft u de maximaal toegestane versie van het pakket dat u wilt installeren.Specifies the maximum allowed version of the package that you want to install. Als u deze parameter niet opgeeft, installeert deze DSC-resource de hoogste nummer beschikbare versie van het pakket.If you do not specify this parameter, this DSC resource installs the highest-numbered available version of the package.
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.
ProviderNameProviderName Hiermee geeft u een providernaam pakket waarnaar als bereik voor uw zoekopdracht pakket.Specifies a package provider name to which to scope your package search. U kunt providernamen pakket ophalen door de cmdlet Get-PackageProvider.You can get package provider names by running the Get-PackageProvider cmdlet.
AdditionalParametersAdditionalParameters Provider specifieke parameters die worden doorgegeven als een hashtabel.Provider specific parameters that are passed as an Hashtable. U kunt bijvoorbeeld aanvullende parameters zoals doelpad doorgeven voor NuGet-provider.For example, for NuGet provider you can pass additional parameters like DestinationPath.

Extra ParametersAdditional Parameters

De volgende tabel geeft een lijst met opties voor de eigenschap AdditionalParameters.The following table lists options for the AdditionalParameters property.

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

VoorbeeldExample

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 vereiste pakket bronnen 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"
        SourceUri   = "http://nuget.org/api/v2/"
        InstallationPolicy ="Trusted"
    }

    PackageManagementSource PSGallery
    {
        Ensure      = "Present"
        Name        = "psgallery"
        ProviderName= "PowerShellGet"
        SourceUri   = "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"
    }
}