Začínáme s Galerie prostředí PowerShell

  • Článek

Galerie prostředí PowerShell je úložiště balíčků obsahující skripty, moduly a prostředky DSC, které si můžete stáhnout a využít. Rutiny v modulu PowerShellGet slouží k instalaci balíčků z Galerie prostředí PowerShell. Abyste mohli stahovat položky z Galerie prostředí PowerShell, nemusíte se přihlašovat.

Poznámka

Balíček je možné stáhnout přímo z Galerie prostředí PowerShell, ale tento postup se nedoporučuje. Další podrobnosti najdete v tématu Ruční stažení balíčku.

Balíčky můžete najít v Galerie prostředí PowerShell pomocí ovládacího prvku Hledat na domovské stránce Galerie prostředí PowerShell nebo procházením modulů a skriptů ze stránky Balíčky. Balíčky můžete také vyhledat ze Galerie prostředí PowerShell spuštěním Find-Modulerutin , Find-DscResourcea Find-Script v závislosti na typu balíčku pomocí -Repository PSGallerypříkazu .

Výsledky z galerie můžete filtrovat pomocí následujících parametrů:

  • Name
  • AllVersions
  • Minimální verze
  • RequiredVersion
  • Značka
  • Zahrnuje
  • DscResource
  • RoleCapability
  • Příkaz
  • Filtrovat

Pokud vás zajímá jenom zjišťování konkrétních prostředků DSC v galerii, můžete spustit rutinu Find-DscResource . Find-DscResource vrací data o prostředcích DSC obsažených v galerii. Vzhledem k tomu, že prostředky DSC se vždy doručují jako součást modulu, stále je potřeba k instalaci těchto prostředků DSC spustit Install-Module .

Jakmile identifikujete balíček, který vás zajímá, můžete se o něm dozvědět více. Můžete to udělat tak, že prozkoumáte konkrétní stránku daného balíčku v galerii. Na této stránce uvidíte všechna metadata nahraná s balíčkem. Tato metadata poskytuje autor balíčku a microsoft je neověřuje. Vlastník balíčku je silně svázán s účtem galerie použitým k publikování balíčku a je důvěryhodnější než pole Autor.

Pokud zjistíte, že balíček není publikovaný v dobré víře, klikněte na stránce balíčku na Nahlásit nevhodné chování .

Pokud používáte nebo Find-ModuleFind-Script, můžete tato data zobrazit ve vráceném objektu PSGetModuleInfo . Následující příklad vrátí data modulu PSReadLine v galerii.

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

Při stahování balíčků z Galerie prostředí PowerShell doporučujeme následující postup:

Zkontrolovat

Pokud chcete stáhnout balíček z galerie ke kontrole, spusťte v závislosti na typu balíčku rutinu Save-Module nebo Save-Script . To vám umožní uložit balíček místně bez instalace a zkontrolovat jeho obsah. Nezapomeňte uložený balíček odstranit ručně.

Některé z těchto balíčků vytvořil Microsoft a jiné komunita PowerShellu. Microsoft doporučuje, abyste si před instalací zkontrolovali obsah a kód balíčků v této galerii.

Pokud zjistíte, že balíček není publikovaný v dobré víře, klikněte na stránce balíčku na Nahlásit nevhodné chování .

Instalace

Pokud chcete nainstalovat balíček z galerie pro použití, v závislosti na typu balíčku spusťte rutinu Install-Module nebo Install-Script .

Install-Module ve výchozím nastavení nainstaluje modul do $env:ProgramFiles\WindowsPowerShell\Modules . To vyžaduje účet správce. Pokud přidáte -Scope CurrentUser parametr , modul se nainstaluje do $HOME\Documents\WindowsPowerShell\Modules .

Install-Script ve výchozím nastavení nainstaluje skript do $env:ProgramFiles\WindowsPowerShell\Scripts nástroje . To vyžaduje účet správce. Pokud přidáte -Scope CurrentUser parametr , skript se nainstaluje do $HOME\Documents\WindowsPowerShell\Scripts .

Ve výchozím nastavení Install-Module nástroj a Install-Script nainstaluje nejnovější verzi balíčku. Pokud chcete nainstalovat starší verzi balíčku, přidejte -RequiredVersion parametr .

Nasadit

Pokud chcete nasadit balíček z Galerie prostředí PowerShell do Azure Automation, klikněte na Azure Automation a potom klikněte na Nasadit a Azure Automation na stránce s podrobnostmi balíčku. Budete přesměrováni na portál pro správu Azure, kde se přihlašujete pomocí přihlašovacích údajů účtu Azure. Všimněte si, že nasazení balíčků se závislostmi nasadí všechny závislosti do Azure Automation. Tlačítko Nasadit do Azure Automation je možné zakázat přidáním značky AzureAutomationNotSupported do metadat balíčku.

Další informace o Azure Automation najdete v dokumentaci k Azure Automation.

Pokud chcete aktualizovat balíčky nainstalované z Galerie prostředí PowerShell, spusťte rutinu Update-Module nebo Update-Script . Při spuštění bez dalších parametrů se Update-Module nástroj pokusí aktualizovat všechny nainstalované moduly spuštěním příkazu Install-Module. Pokud chcete moduly selektivně aktualizovat, přidejte -Name parametr .

Podobně se nástroj při spuštění bez dalších parametrů Update-Script pokusí aktualizovat všechny skripty nainstalované spuštěním příkazu Install-Script. Pokud chcete selektivně aktualizovat skripty, přidejte -Name parametr .

Pokud chcete zjistit, které moduly jste nainstalovali z Galerie prostředí PowerShell, spusťte rutinu Get-InstalledModule . Tento příkaz vypíše všechny moduly, které máte v systému nainstalované přímo z Galerie prostředí PowerShell.

Podobně pokud chcete zjistit, které skripty jste nainstalovali z Galerie prostředí PowerShell, spusťte rutinu Get-InstalledScript . Tento příkaz vypíše všechny skripty, které máte v systému nainstalované přímo z Galerie prostředí PowerShell.

Tyto názvy hostitelů by se měly přidat do seznamů povolených, které řídí přístup z vaší sítě.

Hostitelé vyžadovaní pro zjišťování a stahování balíčků:

  • onegetcdn.azureedge.net – Název hostitele CDN

Hostitelé vyžadovaní při používání webu Galerie prostředí PowerShell:

  • devopsgallerystorage.blob.core.windows.net – název hostitele účtu úložiště
  • *.powershellgallery.com -Webové stránky
  • go.microsoft.com – služba přesměrování

Důležité

Od dubna 2020 Galerie prostředí PowerShell už nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Pokud nepoužíváte protokol TLS 1.2 nebo novější, při pokusu o přístup k Galerie prostředí PowerShell se zobrazí chyba. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:

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

Další informace najdete v tomto oznámení na blogu o PowerShellu.