Začínáme s Galerie prostředí PowerShellGetting Started with the PowerShell Gallery

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.The PowerShell Gallery is a package repository containing scripts, modules, and DSC resources you can download and leverage. Rutiny v modulu PowerShellGet můžete použít k instalaci balíčků z Galerie prostředí PowerShell.You use the cmdlets in the PowerShellGet module to install packages from the PowerShell Gallery. Nemusíte se přihlašovat a stahovat položky z Galerie prostředí PowerShell.You do not need to sign in to download items from the PowerShell Gallery.

Poznámka

Balíček je možné stáhnout přímo z Galerie prostředí PowerShell, ale nejedná se o doporučený postup.It is possible to download a package from the PowerShell Gallery directly, but this is not a recommended approach. Další podrobnosti najdete v tématu Ruční stažení balíčku.For more details, see Manual Package Download.

Balíčky v Galerie prostředí PowerShell můžete najít pomocí ovládacího prvku hledání na domovské stránceGalerie prostředí PowerShell nebo procházením moduly a skripty ze stránky Packages (balíčky).You can find packages in the PowerShell Gallery by using the Search control on the PowerShell Gallery's home page, or by browsing through the Modules and Scripts from the Packages page. Balíčky můžete také vyhledat z Galerie prostředí PowerShell spuštěním rutiny find-Module, find-DscResourcea find-Script v závislosti na typu balíčku s nástrojem -Repository PSGallery .You can also find packages from the PowerShell Gallery by running the Find-Module, Find-DscResource, and Find-Script cmdlets, depending on the package type, with -Repository PSGallery.

Výsledky můžete filtrovat z Galerie pomocí následujících parametrů:You can filter results from the Gallery by using the following parameters:

  • NázevName
  • AllVersionsAllVersions
  • MinimumVersion nešloMinimumVersion
  • RequiredVersionRequiredVersion
  • ZnačkaTag
  • ZahrnujeIncludes
  • DscResourceDscResource
  • RoleCapabilityRoleCapability
  • PříkazCommand
  • FiltrFilter

Pokud vás zajímá jenom zjišťování konkrétních prostředků DSC v galerii, můžete spustit rutinu find-DscResource .If you're only interested in discovering specific DSC resources in the Gallery, you can run the Find-DscResource cmdlet. Find-DscResource vrátí data v prostředcích DSC obsažených v galerii.Find-DscResource returns data on DSC resources contained in the Gallery. Vzhledem k tomu, že prostředky DSC jsou vždy dodávány jako součást modulu, je stále potřeba spustit [instalační modul][] a nainstalovat tyto prostředky DSC.Because DSC resources are always delivered as part of a module, you still need to run Install-Module to install those DSC resources.

Po identifikaci balíčku, na který vás zajímáte, si možná budete chtít o něm získat další informace.Once you've identified a package that you're interested in, you may want to learn more about it. To můžete provést zkoumáním konkrétní stránky balíčku v galerii.You can do this by examining that package's specific page on the Gallery. Na této stránce budete moct zobrazit všechna metadata nahraná pomocí balíčku.On that page, you'll be able to see all of the metadata uploaded with the package. Tato metadata poskytuje autor balíčku a společnost Microsoft je neověřuje.This metadata is provided by the package's author, and is not verified by Microsoft. Vlastník balíčku je silně svázaný s účtem Galerie použitým k publikování tohoto balíčku a je více důvěryhodný než pole Author.The Owner of the package is strongly tied to the Gallery account used to publish the package, and is more trustworthy than the Author field.

Pokud zjistíte, že se jedná o balíček, který se domníváte v dobré víře, klikněte na stránce tohoto balíčku na položku nahlásit zneužití .If you discover a package that you feel is not published in good faith, click Report Abuse on that package's page.

Pokud používáte příkaz find-Module nebo find-Script, můžete tato data zobrazit v vráceném objektu PSGetModuleInfo.If you're running Find-Module or Find-Script, you can view this data in the returned PSGetModuleInfo object. Například spuštění Find-Module -Name PSReadLine -Repository PSGallery |Get-Member vrátí data v modulu PSReadLine v galerii.For example, running Find-Module -Name PSReadLine -Repository PSGallery |Get-Member returns data on the PSReadLine module in the Gallery.

Při stahování balíčků z Galerie prostředí PowerShell doporučujeme následující postup:We encourage the following process when downloading packages from the PowerShell Gallery:

ProhlíženInspect

Chcete-li stáhnout balíček z galerie pro kontrolu, spusťte buď rutinu Save-Module , nebo Save-Script , v závislosti na typu balíčku.To download a package from the Gallery for inspection, run either the Save-Module or Save-Script cmdlet, depending on the package type. To vám umožní místně uložit balíček bez jeho instalace a zkontrolovat obsah balíčku.This lets you save the package locally without installing it, and inspect the package contents. Nezapomeňte uložený balíček odstranit ručně.Remember to delete the saved package manually.

Některé z těchto balíčků jsou vytvořené Microsoftem a jiné jsou vytvořené komunitou PowerShellu.Some of these packages are authored by Microsoft, and others are authored by the PowerShell community. Microsoft doporučuje, abyste před instalací zkontrolovali obsah a kód balíčků v této galerii.Microsoft recommends that you review the contents and code of packages on this gallery prior to installation.

Pokud zjistíte, že se jedná o balíček, který se domníváte v dobré víře, klikněte na stránce tohoto balíčku na položku nahlásit zneužití .If you discover a package that you feel is not published in good faith, click Report Abuse on that package's page.

InstalaceInstall

Pro instalaci balíčku z galerie pro použití spusťte rutinu install-Module nebo install-Script v závislosti na typu balíčku.To install a package from the Gallery for use, run either the Install-Module or Install-Script cmdlet, depending on the package type.

Install-Module nainstaluje ve $env:ProgramFiles\WindowsPowerShell\Modules výchozím nastavení modul.Install-Module installs the module to $env:ProgramFiles\WindowsPowerShell\Modules by default. To vyžaduje účet správce.This requires an administrator account. Pokud přidáte -Scope CurrentUser parametr, modul je nainstalován do nástroje $env:USERPROFILE\Documents\WindowsPowerShell\Modules .If you add the -Scope CurrentUser parameter, the module is installed to $env:USERPROFILE\Documents\WindowsPowerShell\Modules .

Install-Script nainstaluje skript do $env:ProgramFiles\WindowsPowerShell\Scripts výchozího nastavení.Install-Script installs the script to $env:ProgramFiles\WindowsPowerShell\Scripts by default. To vyžaduje účet správce.This requires an administrator account. Pokud přidáte -Scope CurrentUser parametr, nainstaluje se skript do nástroje $env:USERPROFILE\Documents\WindowsPowerShell\Scripts .If you add the -Scope CurrentUser parameter, the script is installed to $env:USERPROFILE\Documents\WindowsPowerShell\Scripts .

Ve výchozím nastavení nainstaluje [modul][] a install-Script nejnovější verzi balíčku.By default, Install-Module and Install-Script installs the most current version of a package. Chcete-li nainstalovat starší verzi balíčku, přidejte -RequiredVersion parametr.To install an older version of the package, add the -RequiredVersion parameter.

NasazeníDeploy

Pokud chcete nasadit balíček z Galerie prostředí PowerShell Azure Automation, klikněte na Azure Automation a pak na stránce s podrobnostmi balíčku klikněte na nasadit na Azure Automation .To deploy a package from the PowerShell Gallery to Azure Automation, click Azure Automation, then click Deploy to Azure Automation on the package details page. Budete přesměrováni na Portál pro správu Azure, kde se přihlašujete pomocí svých přihlašovacích údajů k účtu Azure.You are redirected to the Azure Management Portal where you sign in by using your Azure account credentials. Všimněte si, že nasazení balíčků se závislostmi nasadí všechny závislosti na Azure Automation.Note that deploying packages with dependencies deploys all the dependencies to Azure Automation. Tlačítko nasadit do Azure Automation lze zakázat přidáním značky AzureAutomationNotSupported do metadat balíčku.The 'Deploy to Azure Automation' button can be disabled by adding the AzureAutomationNotSupported tag to your package metadata.

Další informace o Azure Automation najdete v dokumentaci k Azure Automation .To learn more about Azure Automation, see the Azure Automation documentation.

Chcete-li aktualizovat balíčky nainstalované z Galerie prostředí PowerShell, spusťte rutinu Update-Module nebo Update-Script .To update packages installed from the PowerShell Gallery, run either the Update-Module or Update-Script cmdlet. Při spuštění bez jakýchkoli dalších parametrů se [modul aktualizace][] pokusí aktualizovat všechny moduly nainstalované spuštěním rutiny install-Module.When run without any additional parameters, Update-Module attempts to update all modules installed by running Install-Module. Chcete-li selektivně aktualizovat moduly, přidejte -Name parametr.To selectively update modules, add the -Name parameter.

Podobně platí, že při spuštění bez dalších parametrů se [skript Update-Script][] pokusí aktualizovat všechny skripty nainstalované spuštěním rutiny install-Script.Similarly, when run without any additional parameters, Update-Script also attempts to update all scripts installed by running Install-Script. Chcete-li selektivně aktualizovat skripty, přidejte -Name parametr.To selectively update scripts, add the -Name parameter.

Pokud chcete zjistit, které moduly jste nainstalovali z Galerie prostředí PowerShell, spusťte rutinu Get-InstalledModule .To find out which modules you have installed from the PowerShell Gallery, run the Get-InstalledModule cmdlet. Tento příkaz vypíše všechny moduly, které máte ve vašem systému, které se nainstalovaly přímo z Galerie prostředí PowerShell.This command lists all of the modules you have on your system that were installed directly from the PowerShell Gallery.

Podobně pokud chcete zjistit, které skripty jste nainstalovali z Galerie prostředí PowerShell, spusťte rutinu Get-InstalledScript .Similarly, to find out which scripts you have installed from the PowerShell Gallery, run the Get-InstalledScript cmdlet. Tento příkaz vypíše všechny skripty, které máte v systému, nainstalované přímo z Galerie prostředí PowerShell.This command lists all the scripts you have on your system that were installed directly from the PowerShell Gallery.

Galerie prostředí PowerShell používá následující názvy hostitelů.The PowerShell Gallery uses the following hostnames.

  • psg-prod-eastus.azureedge.net – Název hostitele CDNpsg-prod-eastus.azureedge.net - CDN hostname
  • az818661.vo.msecnd.net – Název hostitele CDNaz818661.vo.msecnd.net - CDN hostname
  • devopsgallerystorage.blob.core.windows.net – název hostitele účtu úložištědevopsgallerystorage.blob.core.windows.net - storage account hostname
  • *.powershellgallery.com – Web*.powershellgallery.com - website
  • go.microsoft.com – přesměrování službygo.microsoft.com - redirection service

Tyto názvy hostitelů by měly být přidány do seznamů povolených prvků, které řídí přístup ze sítě.These hostnames should be added to the allow lists that control access from your network.

Důležité

Od dubna 2020 Galerie prostředí PowerShell už nepodporuje verze TLS (Transport Layer Security) 1,0 a 1,1.As of April 2020, the PowerShell Gallery no longer supports Transport Layer Security (TLS) versions 1.0 and 1.1. Pokud nepoužíváte TLS 1,2 nebo vyšší, při pokusu o přístup k Galerie prostředí PowerShell dojde k chybě.If you are not using TLS 1.2 or higher, you will receive an error when trying to access the PowerShell Gallery. Pomocí následujícího příkazu zkontrolujte, že používáte TLS 1,2:Use the following command to ensure you are using TLS 1.2:

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

Další informace najdete v oznámení na blogu PowerShellu.For more information, see the announcement in the PowerShell blog.