Csomagok manuális letöltése
A PowerShell-galéria támogatja a csomagok letöltését közvetlenül a webhelyről a PowerShellGet-parancsmagok használata nélkül. Bármilyen csomagot letölthet NuGet-csomag (.nupkg
) fájlként, amelyet aztán egy belső adattárba másolhat.
Megjegyzés
A manuális csomagletöltés nem helyettesíti a Install-Module
parancsmagot.
A csomag letöltése nem telepíti a modult vagy a szkriptet. A függőségek nem szerepelnek a letöltött NuGet-csomagban. Az alábbi utasítások csak referencia célokra szolgálnak.
Csomag beszerzése manuális letöltéssel
Minden oldal rendelkezik egy kézi letöltésre mutató hivatkozással, az itt látható módon:
A manuális letöltéshez kattintson a Nyers nupkg-fájl letöltése elemre. A rendszer a csomag egy példányát a böngésző letöltési mappájába másolja a következő névvel <name>.<version>.nupkg
: .
A NuGet-csomagok olyan ZIP-archívumok, amelyek további fájlokat tartalmaznak, amelyek a csomag tartalmával kapcsolatos információkat tartalmaznak. Egyes böngészők, például az Internet Explorer automatikusan lecserélik a fájlkiterjesztést a .nupkg
következőre .zip
: . A csomag kibontásához nevezze át a .nupkg
fájlt a következőre .zip
: , ha szükséges, majd bontsa ki a tartalmát egy helyi mappába.
A NuGet-csomagfájl az alábbi NuGet-specifikus elemeket tartalmazza, amelyek nem részei az eredeti csomagolt kódnak:
- Egy nevű
_rels
mappa – egy.rels
olyan fájlt tartalmaz, amely felsorolja a függőségeket - Egy nevű
package
mappa – a NuGet-specifikus adatokat tartalmazza - Egy nevű
[Content_Types].xml
fájl – azt ismerteti, hogy a PowerShellGethez hasonló bővítmények hogyan működnek a NuGettel - Egy nevű
<name>.nuspec
fájl – a metaadatok nagy részét tartalmazza
PowerShell-modulok telepítése NuGet-csomagból
Megjegyzés
Ezek az utasítások NEM ugyanazt az eredményt adják, mint a futtatása Install-Module
. Ezek az utasítások megfelelnek a minimális követelményeknek. Ezek nem a (z) helyére kerülnek Install-Module
.
Az által Install-Module
végrehajtott egyes lépések nem szerepelnek a fájlban.
A legegyszerűbb módszer a NuGet-specifikus elemek eltávolítása a mappából. Az elemek eltávolításakor a csomag szerzője által létrehozott PowerShell-kód marad. A NuGet-specifikus elemek listájáért lásd: Csomag manuális letöltése.
Ennek lépései a következők:
- Oldja fel az internetről letöltött NuGet-csomag (
.nupkg
) fájl blokkolását, például parancsmag használatávalUnblock-File -Path C:\Downloads\module.nupkg
. - Bontsa ki a NuGet-csomag tartalmát egy helyi mappába.
- Törölje a NuGet-specifikus elemeket a mappából.
- Nevezze át a mappát. Az alapértelmezett mappanév általában
<name>.<version>
. A verzió belefoglalható-prerelease
, ha a modul előzetes verzióként van megjelölve. Nevezze át a mappát csak a modul nevére. Például a következő leszazurerm.storage
:azurerm.storage.5.0.4-preview
. - Másolja a mappát a mappában lévő egyik mappába
$env:PSModulePath value
.$env:PSModulePath
egy pontosvesszővel tagolt elérési utak halmaza, amelyekben a PowerShellnek modulokat kell keresnie.
Fontos
A manuális letöltés nem tartalmazza a modul által igényelt függőségeket. Ha a csomag függőségekkel rendelkezik, a modul megfelelő működéséhez telepíteni kell őket a rendszerre. A PowerShell-galéria a csomaghoz szükséges összes függőséget megjeleníti.
PowerShell-szkriptek telepítése NuGet-csomagból
Megjegyzés
Ezek az utasítások NEM ugyanazt az eredményt adják, mint a futtatása Install-Script
. Ezek az utasítások megfelelnek a minimális követelményeknek. Ezek nem a (z) helyére kerülnek Install-Script
.
A legegyszerűbb módszer a NuGet-csomag kinyerése, majd a szkript közvetlen használata.
Ennek lépései a következők:
- Oldja fel az internetről letöltött NuGet-csomag (
.nupkg
) fájl blokkolását, például parancsmag használatávalUnblock-File -Path C:\Downloads\package.nupkg
. - Bontsa ki a NuGet-csomag tartalmát.
- A
.PS1
mappában lévő fájl közvetlenül innen használható. - Törölheti a nuGet-specifikus elemeket a mappából.
A NuGet-specifikus elemek listájáért lásd: Csomag manuális letöltése.
Fontos
A manuális letöltés nem tartalmazza a modul által igényelt függőségeket. Ha a csomag függőségekkel rendelkezik, a modul megfelelő működéséhez telepíteni kell őket a rendszerre. A PowerShell-galéria a csomaghoz szükséges összes függőséget megjeleníti.
PowerShell Gallery