Udostępnij za pomocą

Wprowadzenie do galerii programu PowerShell

Galeria programu PowerShell to repozytorium pakietów zawierające skrypty, moduły i zasoby DSC, które można pobrać i wykorzystać. 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.

Nuta

Pakiet można pobrać bezpośrednio z galerii programu PowerShell, ale nie jest to zalecane podejście. Aby uzyskać więcej informacji, zobacz Ręczne pobieranie pakietów.

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 zidentyfikowaniu interesującego Cię pakietu możesz dowiedzieć się więcej na ten temat. Możesz to zrobić, sprawdzając konkretną stronę pakietu w galerii. Na tej stronie będzie można zobaczyć wszystkie metadane przekazane za pomocą pakietu. Te metadane są dostarczane przez autora pakietu i nie są weryfikowane przez firmę Microsoft. Właściciel pakietu jest silnie powiązany z kontem galerii używanym do publikowania pakietu i jest bardziej godny zaufania niż pole Autor.

Jeśli odkryjesz pakiet, który nie zostanie opublikowany w dobrej wierze, kliknij pozycję 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 na potrzeby inspekcji, uruchom polecenie cmdlet Save-Module lub Save-Script w zależności od typu pakietu. Dzięki temu można zapisywać pakiet lokalnie bez jego instalowania i sprawdzać zawartość pakietu. Pamiętaj, aby ręcznie usunąć zapisany pakiet.

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

Jeśli odkryjesz pakiet, który nie zostanie opublikowany w dobrej wierze, kliknij pozycję 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.

Install-Module domyślnie instaluje moduł w celu $env:ProgramFiles\WindowsPowerShell\Modules. Wymaga to konta administratora. Jeśli dodasz parametr -Scope CurrentUser, moduł zostanie zainstalowany w celu $HOME\Documents\WindowsPowerShell\Modules .

Install-Script domyślnie instaluje skrypt w celu $env:ProgramFiles\WindowsPowerShell\Scripts. Wymaga to konta administratora. Jeśli dodasz parametr -Scope CurrentUser, skrypt zostanie zainstalowany w $HOME\Documents\WindowsPowerShell\Scripts .

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

Wdrożyć

Aby wdrożyć pakiet z galerii programu PowerShell w usłudze Azure Automation, kliknij pozycję Azure Automation, a następnie kliknij pozycję Wdróż w usłudze Azure Automation na stronie szczegółów pakietu. Nastąpi przekierowanie do portalu zarządzania Platformy Azure, w którym logujesz się przy użyciu poświadczeń konta platformy Azure. Należy pamiętać, że wdrażanie pakietów z zależnościami umożliwia wdrożenie wszystkich zależności w usłudze Azure Automation. Przycisk "Wdróż w usłudze 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. Po uruchomieniu bez żadnych dodatkowych parametrów Update-Module próbuje zaktualizować wszystkie moduły zainstalowane przez uruchomienie Install-Module. Aby selektywnie aktualizować moduły, dodaj parametr -Name.

Podobnie po uruchomieniu bez dodatkowych parametrów Update-Script również próbuje zaktualizować wszystkie skrypty zainstalowane przez uruchomienie Install-Script. Aby selektywnie zaktualizować skrypty, dodaj parametr -Name.

Aby dowiedzieć się, które moduły zostały zainstalowane z galerii programu PowerShell, uruchom polecenie 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 zostały zainstalowane w galerii programu PowerShell, uruchom polecenie 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

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

  • Last updated on