Megosztás a következőn keresztül:

Ismerkedés a PowerShell-katalógussal

A PowerShell Galéria egy csomagtároló, amely szkriptek, modulok és DSC erőforrásokat tartalmaz, amelyeket le lehet tölteni és használni. A PowerShellGet modul parancsmagjaival telepíthet csomagokat a PowerShell-gyűjteményből. Nem kell bejelentkeznie ahhoz, hogy elemeket töltsön le a PowerShell-gyűjteményből.

A PowerShell-gyűjteményben a Keresés vezérlővel találhat csomagokat a PowerShell-gyűjtemény kezdőlapján, vagy a Modulok és szkriptek között a Csomagok lap. A PowerShell-gyűjteményből a Find-Module, Find-DscResourceés Find-Script parancsmagok futtatásával is megtalálhatja a csomagtípustól függően a -Repository PSGalleryparancsmagokat.

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

  • Név
  • AllVersions
  • MinimumVersion
  • RequiredVersion
  • Címke
  • Tartalmazza
  • 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 Install-Module kell futtatnia.

Miután kiválasztottál egy csomagot, érdemes lehet többet megtudni róla. Nézd meg a csomagoldalt a Galérián. A csomagoldal tartalmazza a csomaggal feltöltött metaadatokat. A metaadatokat a csomag szerzője biztosítja. A Microsoft nem ellenőrzi ezt az információt. A csomag tulajdonosa a csomag közzétételéhez használt Galéria fiókhoz kapcsolódik. A Tulajdonos fiók tekintélyesebb, mint a Szerző mező.

Ha olyan csomagot találsz, amelyet úgy érzed, nem jóhiszeműen jelent meg, válaszd az adott csomag oldalán a Visszaélés jelentése (Visszaélés jelentése ) opciót.

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

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

A következő folyamatot javasoljuk, amikor csomagokat tölt le a PowerShell-katalógusból:

Ellenőriz

Ha letölt egy csomagot a Galériából ellenőrzésre, használd a Save-Module csomagon lévő or Save-Script cmdlet-eket. Ezek a parancsok helyben mentik el a csomagot anélkül, hogy telepítik. Vizsgáld meg a csomag tartalmát. Ne felejtse el manuálisan törölni a mentett csomagot.

Néhány csomagot a Microsoft készít, másokat pedig a PowerShell közösség. 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 találsz, amelyet úgy érzed, nem jóhiszeműen jelent meg, válaszd az adott csomag oldalán a Visszaélés jelentése (Visszaélés jelentése ) opciót.

Felszerel

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

Alapértelmezés Install-Module szerint a modult telepíti a $env:ProgramFiles\WindowsPowerShell\Modules helyszínre, ami adminisztrátori fiókot igényel. Ha hozzáadod a -Scope CurrentUser paramétert, a parancs telepíti a modult .$HOME\Documents\WindowsPowerShell\Modules

Alapértelmezés Install-Script szerint telepíti a szkriptet, $env:ProgramFiles\WindowsPowerShell\Scripts amely adminisztrátori fiókot igényel. Ha hozzáadod a -Scope CurrentUser paramétert, a parancs telepíti a szkriptet.$HOME\Documents\WindowsPowerShell\Scripts

Install-Module és Install-Script telepíti a csomag legfrissebb verzióját. A csomag régebbi verziójának telepítéséhez adja hozzá a -RequiredVersion paramétert.

Felfejlődik

A PowerShell Galériából Azure Automation-be történő csomag telepítéséhez válassza az Azure Automation-t, majd válassza a csomag részletei oldalán a Deploy to Azure Automation opciót. Az Azure Management Portalra irányítanak, ahol az Azure fiók advívmányával jelentkezel be. Függőségekkel rendelkező csomagok telepítése az összes függőséget az Azure Automation-be telepíti. Deploy to Azure Automation gomb letiltható azzal, hogy hozzáadjuk az AzureAutomationNotSupported címkét a csomag metaadataihoz.

Az Azure Automationről további információt az Azure Automation dokumentációjában talál.

A PowerShell-katalógusból telepített csomagok frissítéséhez futtassa a Update-Module vagy Update-Script parancsmagot. Ha más paraméter Update-Module nélkül fut, megpróbálja frissíteni az összes telepített modult futtatásával Install-Module. A modulok szelektív frissítéséhez adja hozzá a -Name paramétert.

Hasonlóképpen, ha más paraméter nélkül futtatják, Update-Script megpróbálja frissíteni az összes telepített szkriptet futtatásával Install-Script. A szkriptek szelektív frissítéséhez adja hozzá a -Name paramétert.

Ha szeretnéd megtudni, mely modulokat telepítettél a PowerShell Galériából, futtasd le a Get-InstalledModule cmdlet-et. Ez a parancs felsorolja a rendszeren található összes olyan modult, amelyet közvetlenül a PowerShell-katalógusból telepített.

Hasonlóképpen, hogy megtudd, mely szkripteket telepítettél a PowerShell Galériából, futtasd a Get-InstalledScript cmdlet-et. Ez a parancs felsorolja a rendszeren található összes olyan szkriptet, amelyet közvetlenül a PowerShell-gyűjteményből telepített.

Fontos

A PowerShell-galéria Transport Layer Security (TLS) 1.2-es vagy újabb verziót igényel. Ha nem TLS 1.2 vagy újabb verziót használ, hibaüzenet jelenik meg a PowerShell-gyűjtemény elérésekor. A következő 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

Ezeket a gazdagépneveket hozzá kell adni azokhoz 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:

  • cdn.oneget.org
  • cdn.powershellgallery.com

A PowerShell-katalógus webhelyének használatakor szükséges gazdagépek:

  • *.powershellgallery.com – webhely
  • go.microsoft.com és aka.ms – átirányítási szolgáltatások

Jegyzet

A régi végpontok, amelyek a következővel azureedge.net végződtek, már nem támogatottak.

  • Last updated on