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 -AdditionalArguments paramé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"
}
}