DSC PackageManagement-erőforrásDSC PackageManagement Resource

A következőkre vonatkozik: Windows PowerShell 4,0, Windows PowerShell 5,0, Windows PowerShell 5,1Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0, Windows PowerShell 5.1

A Windows PowerShell desired State Configuration (DSC) PackageManagement erőforrása lehetővé teszi a csomagkezelő csomagok telepítésének vagy eltávolításának mechanizmusát a cél csomóponton.The PackageManagement resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to install or uninstall Package Management packages on a target node. Ehhez az erőforráshoz a PackageManagement modul szükséges https://PowerShellGallery.com .This resource requires the PackageManagement module, available from https://PowerShellGallery.com.

Fontos

A PackageManagement modulnak legalább 1.1.7.0 kell lennie ahhoz, hogy a következő tulajdonság adatai helyesek legyenek.The PackageManagement module should be at least version 1.1.7.0 for the following property information to be correct.

SyntaxSyntax

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

TulajdonságokProperties

TulajdonságProperty LeírásDescription
NévName A telepítendő vagy eltávolítandó csomag nevét adja meg.Specifies the name of the Package to be installed or uninstalled.
AdditionalParametersAdditionalParameters Szolgáltatói specifikus szórótábla, amelyeket át kell adni Get-Package -AdditionalArguments .Provider specific hashtable of parameters that would be passed to Get-Package -AdditionalArguments. A NuGet-szolgáltató esetében például további paramétereket adhat át, például a DestinationPath-t.For example, for NuGet provider you can pass additional parameters like DestinationPath.
Maximumversion elemhez kötelezőMaximumVersion Megadja a megkeresni kívánt csomag maximálisan engedélyezett verzióját.Specifies the maximum allowed version of the package that you want to find. Ha nem adja hozzá ezt a paramétert, az erőforrás megkeresi a csomag legmagasabb rendelkezésre álló verzióját.If you do not add this parameter, the resource finds the highest available version of the package.
MinimumVersionMinimumVersion Megadja a megkeresni kívánt csomag minimálisan engedélyezett verzióját.Specifies the minimum allowed version of the package that you want to find. Ha nem adja hozzá ezt a paramétert, az erőforrás megkeresi a csomag legmagasabb rendelkezésre álló verzióját, amely a maximumversion elemhez kötelező paraméterben megadott maximálisan megadott verziót is kielégíti.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 Megadja azt a csomag-szolgáltatói nevet, amelyre a csomag keresésének hatóköre vonatkozik.Specifies a package provider name to which to scope your package search. A csomagok szolgáltatójának nevét a parancsmag futtatásával kérheti le Get-PackageProvider .You can get package provider names by running the Get-PackageProvider cmdlet.
RequiredVersionRequiredVersion Megadja a telepíteni kívánt csomag pontos verzióját.Specifies the exact version of the package that you want to install. Ha nem adja meg ezt a paramétert, ez a DSC-erőforrás telepíti a csomag legújabb elérhető verzióját, amely a maximumversion elemhez kötelező paraméter által megadott maximális verziót is kielégíti.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.
ForrásSource Annak a csomagnak a nevét adja meg, ahol a csomag található.Specifies the name of the package source where the package can be found. Ez lehet egy URI vagy egy, a Register-PackageSource vagy PACKAGEMANAGEMENTSOURCE DSC-erőforrással regisztrált forrás.This can either be a URI or a source registered with Register-PackageSource or PackageManagementSource DSC resource.
SourceCredentialSourceCredential Egy olyan felhasználói fiókot ad meg, amely jogosultsággal rendelkezik csomag telepítésére egy adott csomag-szolgáltató vagy-forrás számára.Specifies a user account that has rights to install a package for a specified package provider or source.

További paraméterekAdditional Parameters

A következő táblázat a AdditionalParameters tulajdonsághoz tartozó beállításokat sorolja fel.The following table lists options for the AdditionalParameters property.

ParaméterParameter LeírásDescription
DestinationPathDestinationPath A szolgáltatók használják, például a beépített Nuget-szolgáltató.Used by providers such as the built-in Nuget Provider. Itt adható meg a fájl helye, ahová telepíteni szeretné a csomagot.Specifies a file location where you want the package to be installed.
InstallationPolicyInstallationPolicy A szolgáltatók használják, például a beépített Nuget-szolgáltató.Used by providers such as the built-in Nuget Provider. Meghatározza, hogy megbízható-e a csomag forrása.Determines whether you trust the package's source. Az egyik: nem megbízható vagy megbízható.One of: Untrusted or Trusted.

Közös tulajdonságokCommon properties

TulajdonságProperty LeírásDescription
DependsOnDependsOn Azt jelzi, hogy egy másik erőforrás konfigurációjának futnia kell az erőforrás konfigurálása előtt.Indicates that the configuration of another resource must run before this resource is configured. Ha például az az erőforrás-konfigurációs parancsfájl blokkja, amelyet először szeretne futtatni, ResourceName, és a típusa ResourceType, a tulajdonság használatának szintaxisa a következő: DependsOn = "[ResourceType]ResourceName" .For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".
BiztosításaEnsure Meghatározza, hogy a csomag telepítése vagy eltávolítása megtörtént-e.Determines whether the package is to be installed or uninstalled. Az alapértelmezett érték jelenvan.The default value is Present.
PsDscRunAsCredentialPsDscRunAsCredential Beállítja a teljes erőforrás futtatásához használt hitelesítő adatokat.Sets the credential for running the entire resource as.

Megjegyzés

A PsDscRunAsCredential Common tulajdonsága a WMF 5,0-ben lett hozzáadva, hogy bármely DSC-erőforrást más hitelesítő adatok kontextusában futtasson.The PsDscRunAsCredential common property was added in WMF 5.0 to allow running any DSC resource in the context of other credentials. További információ: a hitelesítő adatok használata a DSC-erőforrásokkal.For more information, see Use Credentials with DSC Resources.

PéldaExample

Ez a példa a jQuery NuGet-csomagot és a GistProvider PowerShell-modult telepíti a PackageManagement DSC-erőforrás használatával.This example installs the JQuery NuGet package and GistProvider PowerShell module using the PackageManagement DSC resource. Ez a példa először biztosítja a szükséges csomagok forrásait, majd meghatározza a jQuery és a GistProvider csomagok várható állapotát (NuGet és PowerShell).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"
    }
}