Sdílet prostřednictvím

Začínáme s galerií 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 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.

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 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.

Jakmile identifikujete balíček, který vás zajímá, můžete se o něm dozvědět víc. 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á balíčkem. Tato metadata poskytuje autor balíčku a společnost Microsoft je neověřením. Vlastník balíčku je silně svázaný 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, který cítíte, není publikován v dobré víře, klikněte na Nahlásit zneužití na stránce daného balíčku.

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

Pokud chcete stáhnout balíček z galerie pro kontrolu, spusťte v závislosti na typu balíčku Save-Module nebo Save-Script rutinu. Díky tomu můžete balíček uložit místně, aniž byste ho nainstalovali, a zkontrolovat obsah balíčku. Nezapomeňte uložený balíček odstranit ručně.

Některé z těchto balíčků vytváří Microsoft a jiné jsou vytvořené komunitou PowerShellu. 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, který cítíte, není publikován v dobré víře, klikněte na Nahlásit zneužití na stránce daného balíčku.

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.

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

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

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

Nasadit

Pokud chcete nasadit balíček z galerie PowerShellu do služby Azure Automation, klikněte na Azure Automation a potom klikněte na Nasadit do služby Azure Automation na stránce podrobností 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 služby Azure Automation. Tlačítko Nasadit do služby Azure Automation je možné zakázat přidáním značky 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 Update-Module pokusí aktualizovat všechny moduly nainstalované spuštěním Install-Module. Pokud chcete selektivně aktualizovat moduly, přidejte parametr -Name.

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

Pokud chcete zjistit, které moduly jste nainstalovali z galerie Prostředí PowerShell, spusťte rutinu Get-InstalledModule. 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ě pokud chcete zjistit, které skripty jste nainstalovali z Galerie prostředí PowerShell, spusťte rutinu Get-InstalledScript. 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.

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ů:

  • onegetcdn.azureedge.net
  • powershellgallery.azureedge.net
  • psg-prod-eastus.azureedge.net

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í

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 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

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

  • 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