Share via


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:

Csomagmegjelenítési oldal telepítési beállításokkal

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:

  1. Oldja fel az internetről letöltött NuGet-csomag (.nupkg) fájl blokkolását, például parancsmag használatával Unblock-File -Path C:\Downloads\module.nupkg .
  2. Bontsa ki a NuGet-csomag tartalmát egy helyi mappába.
  3. Törölje a NuGet-specifikus elemeket a mappából.
  4. 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 .
  5. 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:

  1. Oldja fel az internetről letöltött NuGet-csomag (.nupkg) fájl blokkolását, például parancsmag használatával Unblock-File -Path C:\Downloads\package.nupkg .
  2. Bontsa ki a NuGet-csomag tartalmát.
  3. A .PS1 mappában lévő fájl közvetlenül innen használható.
  4. 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.