DSC packageManagement erőforrás

Érintett kiadások: Windows PowerShell 4.0, Windows PowerShell 5.0, Windows PowerShell 5.1

A Windows PowerShell Desired State Configuration (DSC) PackageManagement erőforrása egy mechanizmust biztosít a csomagkezelési csomagok célcsomóponton való telepítéséhez vagy eltávolításához. Ehhez az erőforráshoz a csomagkezelő modul szükséges, amely a következőből https://PowerShellGallery.comérhető el: .

Fontos

A PackageManagement modulnak legalább 1.1.7.0-s verziójúnak kell lennie ahhoz, hogy a következő tulajdonságadatok helyesek legyenek.

Megjegyzés

A DSC-erőforrás dokumentációja a PowerShell 7.2-es verzió előtti verzióját ismerteti. A PSDscResources modul a Microsoft által hivatalosan támogatott új és frissített DSC-erőforrásokat tartalmaz. A PSDscResources modul a PowerShell-galéria érhető el.

További információkért és a frissített dokumentációért tekintse meg a PSDscResources referenciadokumentációját.

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

Tulajdonságok

Tulajdonság	Leírás
Name (Név)	Megadja a telepíteni vagy eltávolítani kívánt csomag nevét.
Továbbiparaméterek	A(z) számára átadott Get-Package -AdditionalArgumentsparaméterek szolgáltatóspecifikus kivonattáblája. Például a NuGet-szolgáltató esetében további paramétereket adhat át, például a Cél paramétert.
MaximumVersion	A megkeresni kívánt csomag maximálisan engedélyezett verzióját adja meg. Ha nem adja hozzá ezt a paramétert, az erőforrás megkeresi a csomag legmagasabb elérhető verzióját.
MinimumVersion	A keresett csomag minimálisan engedélyezett verzióját adja meg. Ha nem adja hozzá ezt a paramétert, az erőforrás megkeresi a csomag legmagasabb elérhető verzióját, amely megfelel a MaximumVersion paraméter által megadott maximálisan megadott verziónak is.
ProviderName	Megadja a csomagszolgáltató nevét, amelyre a csomagkeresés hatókörét ki szeretné terjedni. A csomagszolgáltató nevét a Get-PackageProvider parancsmag futtatásával szerezheti be.
RequiredVersion	Megadja a telepíteni kívánt csomag pontos verzióját. 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 megfelel a MaximumVersion paraméter által megadott maximális verziónak is.
Forrás	Megadja annak a csomagforrásnak a nevét, ahol a csomag megtalálható. Ez lehet egy URI, vagy egy, a PackageManagementSource DSC-erőforrásban Register-PackageSource regisztrált forrás.
SourceCredential	Olyan felhasználói fiókot ad meg, amely jogosultságokkal rendelkezik egy adott csomagszolgáltatóhoz vagy -forráshoz tartozó csomag telepítéséhez.

További paraméterek

Az alábbi táblázat az AdditionalParameters tulajdonság beállításait sorolja fel.

Paraméter	Leírás
Cél	Olyan szolgáltatók használják, mint a beépített Nuget-szolgáltató. Megadja a fájl helyét, ahová telepíteni szeretné a csomagot.
InstallationPolicy	Olyan szolgáltatók használják, mint a beépített Nuget-szolgáltató. Meghatározza, hogy megbízik-e a csomag forrásában. Az egyik: Nem megbízható vagy Megbízható.

Közös tulajdonságok

Tulajdonság	Leírás
DependsOn	Azt jelzi, hogy egy másik erőforrás konfigurációjának futnia kell az erőforrás konfigurálása előtt. Ha például az először futtatni kívánt erőforrás-konfigurációs szkriptblokk azonosítója ResourceName, és a típusa ResourceType, akkor a tulajdonság használatának szintaxisa a következő DependsOn = "[ResourceType]ResourceName": .
Biztosítja	Meghatározza, hogy a csomagot telepíteni vagy eltávolítani kell-e. Az alapértelmezett érték a Jelenik.
PsDscRunAsCredential	Beállítja a teljes erőforrás futtatásához szükséges hitelesítő adatokat.

Megjegyzés

A PsDscRunAsCredential közös tulajdonság hozzáadva a WMF 5.0-hoz, hogy bármely DSC-erőforrást más hitelesítő adatok kontextusában futtathasson. További információ: Hitelesítő adatok használata DSC-erőforrásokkal.

Példa

Ez a példa telepíti a JQuery NuGet-csomagot és a GistProvider PowerShell-modult a PackageManagement DSC erőforrás használatával. Ez a példa először biztosítja, hogy a szükséges csomagforrások elérhetők legyenek, majd meghatározza a JQuery - és GistProvider-csomagok (NuGet és PowerShell) várt állapotát.

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