Első lépések a PowerShell-galéria

  • Cikk

A PowerShell-galéria egy csomagtár, amely szkripteket, modulokat és DSC-erőforrásokat tartalmaz, amelyek letölthetők és kihasználhatók. A PowerShellGet modul parancsmagjaival telepíthet csomagokat a PowerShell-galéria. Az elemek PowerShell-galéria való letöltéséhez nem kell bejelentkeznie.

Megjegyzés

A csomagot közvetlenül is letöltheti a PowerShell-galéria, de ez nem ajánlott módszer. További részletekért lásd: Manuális csomagletöltés.

A csomagokat a PowerShell-galéria a PowerShell-galéria kezdőlapján található Keresés vezérlővel, vagy a Csomagok lapon a Modulok és szkriptek között böngészve találhatja meg. A csomagok a PowerShell-galéria is megtalálhatók, ha a Find-Module, Find-DscResource, és Find-Script parancsmagokat futtatja a csomag típusától függően a következővel-Repository PSGallery: .

A katalógusból származó eredményeket a következő paraméterekkel szűrheti:

  • Name
  • AllVersions
  • MinimumVerzió
  • RequiredVersion
  • Címke
  • Beágyazások
  • DscResource
  • RoleCapability
  • Parancs
  • Szűrő

Ha csak bizonyos DSC-erőforrásokat szeretne felderíteni a katalógusban, futtathatja a Find-DscResource parancsmagot. Find-DscResource a katalógusban található DSC-erőforrások adatait adja vissza. Mivel a DSC-erőforrások mindig egy modul részeként érkeznek, a DSC-erőforrások telepítéséhez továbbra is futnia Install-Module kell.

Miután azonosított egy csomagot, amely érdekli, érdemes lehet többet megtudni róla. Ezt úgy teheti meg, hogy megvizsgálja a csomag adott oldalát a katalógusban. Ezen a lapon láthatja a csomaggal feltöltött összes metaadatot. Ezt a metaadatokat a csomag szerzője biztosítja, és a Microsoft nem ellenőrzi. A csomag tulajdonosa erősen kötődik a csomag közzétételéhez használt Katalógus fiókhoz, és megbízhatóbb, mint a Szerző mező.

Ha olyan csomagot fedez fel, amelyet úgy érez, hogy nem jóhiszeműen tett közzé, kattintson a Visszaélés bejelentése elemre a csomag oldalán.

Ha a vagy Find-Scripta parancsot futtatjaFind-Module, megtekintheti ezeket az adatokat a visszaadott PSGetModuleInfo objektumban. Az alábbi példa a gyűjtemény PSReadLine moduljának adatait adja vissza.

Find-Module -Name PSReadLine -Repository PSGallery | Get-Member

A csomagok PowerShell-galéria való letöltésekor a következő folyamatot javasoljuk:

Ellenőrizni

Ha vizsgálatra szeretne letölteni egy csomagot a katalógusból, futtassa a vagy Save-Script a Save-Module parancsmagot a csomag típusától függően. Ez lehetővé teszi a csomag helyi mentését telepítés nélkül, és megvizsgálhatja a csomag tartalmát. Ne felejtse el manuálisan törölni a mentett csomagot.

Ezen csomagok némelyikét a Microsoft, míg mások a PowerShell-közösség szerzői. A Microsoft azt javasolja, hogy a telepítés előtt tekintse át a katalógusban található csomagok tartalmát és kódját.

Ha olyan csomagot fedez fel, amelyet úgy érez, hogy nem jóhiszeműen tett közzé, kattintson a Visszaélés bejelentése elemre a csomag oldalán.

Telepítés

Ha a katalógusból szeretne csomagot telepíteni használatra, futtassa a vagy Install-Script a Install-Module parancsmagot a csomag típusától függően.

Install-Module alapértelmezés szerint telepíti a modult $env:ProgramFiles\WindowsPowerShell\Modules . Ehhez rendszergazdai fiókra van szükség. Ha hozzáadja a paramétert -Scope CurrentUser , a modul a következőre $HOME\Documents\WindowsPowerShell\Modules lesz telepítve: .

Install-Script alapértelmezés szerint telepíti a szkriptet $env:ProgramFiles\WindowsPowerShell\Scripts . Ehhez rendszergazdai fiókra van szükség. Ha hozzáadja a paramétert -Scope CurrentUser , a szkript a következőre $HOME\Documents\WindowsPowerShell\Scripts lesz telepítve: .

Alapértelmezés szerint a Install-Module csomag Install-Script legújabb verzióját telepíti. A csomag régebbi verziójának telepítéséhez adja hozzá a paramétert -RequiredVersion .

Üzembe helyezés

Ha egy csomagot a PowerShell-galéria Azure Automation szeretne üzembe helyezni, kattintson a Azure Automation elemre, majd a Csomag részletei lapon kattintson az Üzembe helyezés Azure Automation elemre. A rendszer átirányítja az Azure Management Portalra, ahol az Azure-fiók hitelesítő adataival jelentkezik be. Vegye figyelembe, hogy a függőségekkel rendelkező csomagok üzembe helyezése az összes függőséget üzembe helyezi a Azure Automation. Az "Üzembe helyezés Azure Automation" gomb letiltható, ha hozzáadja az AzureAutomationNotSupported címkét a csomag metaadataihoz.

A Azure Automation további információért tekintse meg a Azure Automation dokumentációját.

A PowerShell-galéria telepített csomagok frissítéséhez futtassa a vagy Update-Script a Update-Module parancsmagot. Ha további paraméterek nélkül fut, Update-Module megkísérli frissíteni az összes telepített modult a futtatásával Install-Module. A modulok szelektív frissítéséhez adja hozzá a paramétert -Name .

Hasonlóképpen, ha a futtatás további paraméterek nélkül történik, Update-Script a futtatásával Install-Scriptaz összes telepített szkriptet is megpróbálja frissíteni. A szkriptek szelektív frissítéséhez adja hozzá a paramétert -Name .

Ha meg szeretné tudni, hogy mely modulokat telepítette a PowerShell-galéria, futtassa a Get-InstalledModule parancsmagot. Ez a parancs felsorolja a rendszeren található összes olyan modult, amelyet közvetlenül a PowerShell-galéria telepített.

Hasonlóképpen, ha meg szeretné tudni, hogy mely szkripteket telepítette a PowerShell-galéria, futtassa a Get-InstalledScript parancsmagot. Ez a parancs felsorolja a rendszeren található összes olyan szkriptet, amelyet közvetlenül a PowerShell-galéria telepített.

Ezeket a gazdagépneveket hozzá kell adni az engedélyezési listákhoz, amelyek a hálózatról való hozzáférést szabályozzák.

A csomagok felderítéséhez és letöltéséhez szükséges gazdagépek:

  • onegetcdn.azureedge.net - CDN-állomásnév

A PowerShell-galéria webhely használatakor szükséges gazdagépek:

  • devopsgallerystorage.blob.core.windows.net - tárfiók gazdagépneve
  • *.powershellgallery.com -Honlap
  • go.microsoft.com - átirányítási szolgáltatás

Fontos

2020 áprilisától a PowerShell-galéria már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. Ha nem TLS 1.2-t vagy újabb verziót használ, hibaüzenet jelenik meg a PowerShell-galéria elérésekor. Az alábbi paranccsal győződjön meg arról, hogy a TLS 1.2-t használja:

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

További információért tekintse meg a bejelentést a PowerShell-blogon.