Udostępnij przez

Wprowadzenie do galerii programu PowerShell

Galeria PowerShell to repozytorium pakietów zawierające skrypty, moduły oraz zasoby DSC, które możesz pobrać i używać. Polecenia cmdlet w module PowerShellGet służą do instalowania pakietów z galerii programu PowerShell. Nie musisz logować się, aby pobrać elementy z galerii programu PowerShell.

Pakiety można znaleźć w galerii programu PowerShell przy użyciu kontrolki wyszukiwania na stronie głównej galerii programu PowerShell lub przeglądając stronę Moduły i skrypty na stronie pakiety . Pakiety można również znaleźć w galerii programu PowerShell, uruchamiając polecenia cmdlet Find-Module, Find-DscResourcei Find-Script, w zależności od typu pakietu z -Repository PSGallery.

Wyniki z galerii można filtrować przy użyciu następujących parametrów:

  • Nazwa
  • AllVersions
  • Minimalna wersja
  • RequiredVersion
  • Znacznik
  • Zawiera
  • DscResource
  • RoleCapability
  • Polecenie
  • Filtr

Jeśli interesuje Cię tylko odnajdywanie określonych zasobów DSC w galerii, możesz uruchomić polecenie cmdlet Find-DscResource. Find-DscResource zwraca dane dotyczące zasobów DSC zawartych w galerii. Ponieważ zasoby DSC są zawsze dostarczane w ramach modułu, nadal trzeba uruchomić Install-Module, aby zainstalować te zasoby DSC.

Po wybraniu pakietu warto dowiedzieć się o nim więcej. Sprawdź stronę opakowania w Galerii. Strona pakietu zawiera metadane przesłane wraz z pakietem. Metadane dostarcza autor pakietu. Microsoft nie weryfikuje tych informacji. Właściciel pakietu jest powiązany z kontem Galerii używanym do publikacji pakietu. Konto Właściciel jest bardziej autorytatywne niż pole Autor.

Jeśli odkryjesz pakiet, który według Ciebie nie został opublikowany w dobrej wierze, wybierz Zgłoś nadużycie na stronie tego pakietu.

Jeśli używasz Find-Module lub Find-Script, możesz wyświetlić te dane w zwróconym obiekcie PSGetModuleInfo. Poniższy przykład zwraca dane w module PSReadLine w galerii.

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

Zachęcamy do następującego procesu podczas pobierania pakietów z galerii programu PowerShell:

Sprawdzić

Aby pobrać pakiet z Galerii do inspekcji, użyj Save-Module instrukcji lub Save-Script na opakowaniu. Te polecenia zapisują pakiet lokalnie bez konieczności instalowania. Sprawdź zawartość opakowania. Pamiętaj, aby ręcznie usunąć zapisany pakiet.

Niektóre pakiety są tworzone przez Microsoft, inne przez społeczność PowerShell. Firma Microsoft zaleca przejrzenie zawartości i kodu pakietów w tej galerii przed instalacją.

Jeśli odkryjesz pakiet, który według Ciebie nie został opublikowany w dobrej wierze, wybierz Zgłoś nadużycie na stronie tego pakietu.

Instalować

Aby zainstalować pakiet z galerii do użycia, uruchom polecenie cmdlet Install-Module lub Install-Script w zależności od typu pakietu.

Domyślnie Install-Module moduł instaluje się w $env:ProgramFiles\WindowsPowerShell\Modules lokalizacji, co wymaga konta administratora. Jeśli dodasz parametr, -Scope CurrentUser polecenie instaluje moduł w .$HOME\Documents\WindowsPowerShell\Modules

Domyślnie skrypt Install-Script instaluje się do $env:ProgramFiles\WindowsPowerShell\Scripts lokalizacji, co wymaga konta administratora. Jeśli dodasz parametr, -Scope CurrentUser polecenie instaluje skrypt w $HOME\Documents\WindowsPowerShell\Scripts.

Install-Module i Install-Script instaluje najnowszą wersję pakietu. Aby zainstalować starszą wersję pakietu, dodaj parametr -RequiredVersion.

Wdrożyć

Aby wdrożyć pakiet z PowerShell Gallery do Azure Automation, wybierz Azure Automation, a następnie Deploy to Azure Automation na stronie szczegółów pakietu. Zostajesz przekierowany do Azure Management Portal, gdzie logujesz się za pomocą danych uwierzytelniających do konta Azure. Wdrażanie pakietów z zależnościami wdraża wszystkie zależności do Azure Automation. Przycisk Deploy to Azure Automation można wyłączyć, dodając tag AzureAutomationNotSupported do metadanych pakietu.

Aby dowiedzieć się więcej na temat usługi Azure Automation, zobacz dokumentację Azure Automation.

Aby zaktualizować pakiety zainstalowane z galerii programu PowerShell, uruchom polecenie cmdlet Update-Module lub Update-Script. Gdy uruchamia się bez innych parametrów, próbuje zaktualizować wszystkie zainstalowane moduły, Update-Module uruchamiając Install-Module. Aby selektywnie aktualizować moduły, dodaj parametr -Name.

Podobnie, gdy uruchamia się bez innych parametrów, również próbuje zaktualizować wszystkie zainstalowane skrypty, Update-Script uruchamiając Install-Script. Aby selektywnie zaktualizować skrypty, dodaj parametr -Name.

Aby dowiedzieć się, które moduły zainstalowałeś, uruchom cmdlet.Get-InstalledModule To polecenie wyświetla listę wszystkich modułów zainstalowanych w systemie bezpośrednio z galerii programu PowerShell.

Podobnie, aby dowiedzieć się, które skrypty zainstalowałeś z galerii PowerShell, uruchom cmdlet Get-InstalledScript . To polecenie wyświetla listę wszystkich skryptów zainstalowanych w systemie bezpośrednio z galerii programu PowerShell.

Ważny

Galeria programu PowerShell wymaga protokołu Transport Layer Security (TLS) 1.2 lub nowszego. Jeśli nie używasz protokołu TLS 1.2 lub nowszego, podczas próby uzyskania dostępu do galerii programu PowerShell zostanie wyświetlony błąd. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:

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

Te nazwy hostów należy dodać do list dozwolonych, które kontrolują dostęp z sieci.

Hosty wymagane do odnajdywania i pobierania pakietów:

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

Hosty wymagane podczas korzystania z witryny sieci Web galerii programu PowerShell:

  • *.powershellgallery.com — witryna internetowa
  • go.microsoft.com i aka.ms — usługi przekierowania

Nuta

Stare punkty końcowe, które kończyły się na azureedge.net , nie są już obsługiwane.

  • Last updated on