Začínáme s galerií Prostředí PowerShell

PowerShell Gallery je repozitář balíčků obsahující skripty, moduly a DSC zdroje, které si můžete stáhnout a používat. Rutiny v modulu PowerShellGet použijete 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.

Balíčky najdete v Galerii Prostředí PowerShell pomocí ovládacího prvku Hledat na domovské stránce galerie PowerShellu nebo procházením modulů a skriptů na stránce Balíčky. Balíčky najdete také v Galerii Prostředí PowerShell spuštěním rutin Find-Module, Find-DscResourcea Find-Script v závislosti na typu balíčku s -Repository PSGallery.

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

  • Jméno
  • AllVersions
  • MinimumVersion
  • RequiredVersion
  • Značka
  • Zahrnuje
  • DscResource
  • RoleCapability
  • Příkaz
  • Filtr

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, musíte stále spouštět Install-Module k instalaci těchto prostředků DSC.

Poté, co si vyberete balíček, možná se o něm budete chtít dozvědět více. Prohlédněte si stránku balíčku v Galerii. Stránka balíčku obsahuje metadata nahraná s balíčkem. Metadata poskytuje autor balíčku. Microsoft tyto informace neověřuje. Vlastník balíčku je spojen s účtem Galerie, který byl použit k publikování balíčku. Účet Vlastník je autoritativnější než pole Autor.

Pokud zjistíte, že balíček nebyl zveřejněn v dobré víře, vyberte na stránce tohoto balíčku Nahlásit zneužití .

Pokud používáte Find-Module nebo Find-Script, můžete tato data zobrazit ve vráceném objektu PSGetModuleInfo. Následující příklad vrátí data v 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:

Prozkoumat

Pro stažení balíčku z galerie k inspekci použijte Save-Module příkazové příkazy nebo Save-Script na balení. Tyto příkazy ukládají balíček lokálně bez jeho instalace. Prohlédněte si obsah obalu. Nezapomeňte uložený balíček odstranit ručně.

Některé balíčky vytváří Microsoft, jiné komunita PowerShell. Společnost Microsoft doporučuje před instalací zkontrolovat obsah a kód balíčků v této galerii.

Pokud zjistíte, že balíček nebyl zveřejněn v dobré víře, vyberte na stránce tohoto balíčku Nahlásit zneužití .

Nainstalovat

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

Ve výchozím nastavení Install-Module se modul instaluje na $env:ProgramFiles\WindowsPowerShell\Modules dané místo, což vyžaduje administrátorský účet. Pokud parametr přidáte-Scope CurrentUser, příkaz nainstaluje modul do .$HOME\Documents\WindowsPowerShell\Modules

Ve výchozím nastavení Install-Script se skript instaluje na $env:ProgramFiles\WindowsPowerShell\Scripts lokaci, což vyžaduje administrátorský účet. Pokud parametr přidáte -Scope CurrentUser , příkaz nainstaluje skript do $HOME\Documents\WindowsPowerShell\Scripts.

Install-Module a nainstaluje Install-Script nejnovější verzi balíčku. Pokud chcete nainstalovat starší verzi balíčku, přidejte parametr -RequiredVersion.

Nasadit

Pro nasazení balíčku z PowerShell Gallery do Azure Automation vyberte Azure Automation a poté na stránce s detaily balíčku zvolte Deploy to Azure Automation . Jste přesměrováni do Azure Management Portalu, kde se přihlašujete pomocí přihlašovacích údajů k Azure účtu. Nasazování balíčků s dependenciemi nasadí všechny závislosti do Azure Automation. Tlačítko Deploy to Azure Automation lze deaktivovat přidáním tagu AzureAutomationNotSupported do metadat balíčku.

Další informace o službě Azure Automation najdete v dokumentaci ke službě 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 pokusí Update-Module aktualizovat všechny nainstalované moduly spuštěním Install-Module. Pokud chcete selektivně aktualizovat moduly, přidejte parametr -Name.

Podobně, když běží bez dalších parametrů, se Update-Script také snaží aktualizovat všechny nainstalované skripty spuštěním .Install-Script Chcete-li selektivně aktualizovat skripty, přidejte parametr -Name.

Chcete-li zjistit, které moduly jste nainstalovali z PowerShell Gallery, spusťte Get-InstalledModule CMDLET. Tento příkaz zobrazí seznam všech modulů, které máte ve svém systému nainstalované přímo z Galerie prostředí PowerShell.

Podobně, abyste zjistili, které skripty jste nainstalovali z PowerShell Gallery, spusťte Get-InstalledScript cmdlet. Tento příkaz zobrazí seznam všech skriptů, které máte ve svém systému, které byly nainstalovány přímo z Galerie prostředí PowerShell.

Důležitý

Galerie prostředí PowerShell vyžaduje protokol TLS (Transport Layer Security) 1.2 nebo novější. Pokud nepoužíváte protokol TLS 1.2 nebo vyšší, při pokusu o přístup k galerii 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

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í ke zjišťování a stahování balíčků:

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

Hostitelé vyžadovaní při použití webu Galerie Prostředí PowerShell:

  • *.powershellgallery.com – web
  • go.microsoft.com a aka.ms – služby přesměrování

Poznámka

Staré koncové body, které končily na azureedge.net , již nejsou podporovány.

  • Find-DscResource
  • find-module
  • najít skript
  • Get-InstalledModule
  • Get-InstalledScript
  • install-module
  • instalačního skriptu
  • publish-module
  • publikování skriptu
  • Register-PSRepository
  • Uložit modul
  • uložit skript
  • aktualizačního modulu
  • aktualizačního skriptu
  • Last updated on