Wprowadzenie z Galeria programu PowerShell

  • Artykuł

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 Galeria programu PowerShell. Nie musisz logować się, aby pobrać elementy z Galeria programu PowerShell.

Uwaga

Istnieje możliwość pobrania pakietu bezpośrednio z Galeria programu PowerShell, ale nie jest to zalecane podejście. Aby uzyskać więcej informacji, zobacz Pobieranie ręcznego pakietu.

Pakiety można znaleźć w Galeria programu PowerShell za pomocą kontrolki Wyszukiwanie na stronie głównej Galeria programu PowerShell lub przeglądając moduły i skrypty na stronie Pakiety. Pakiety można również znaleźć w Galeria programu PowerShell, uruchamiając Find-Modulepolecenia cmdlet , 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
  • Tag
  • Zawiera
  • DscResource
  • RolaCapability
  • Polecenie
  • Filtr

Jeśli interesuje Cię tylko odnajdywanie określonych zasobów DSC w galerii, możesz uruchomić Find-DscResource polecenie cmdlet . 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 zobaczysz 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 jest publikowany w dobrej wierze, kliknij pozycję Zgłoś nadużycie na stronie tego pakietu.

Jeśli używasz Find-Module polecenia 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 Galeria programu PowerShell:

Kontrola

Aby pobrać pakiet z galerii do inspekcji, uruchom Save-Module polecenie cmdlet 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 jest publikowany w dobrej wierze, kliknij pozycję Zgłoś nadużycie na stronie tego pakietu.

Instalowanie

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

Install-Module program instaluje moduł domyślnie $env:ProgramFiles\WindowsPowerShell\Modules . Wymaga to konta administratora. W przypadku dodania parametru -Scope CurrentUser moduł zostanie zainstalowany w programie $HOME\Documents\WindowsPowerShell\Modules .

Install-Script domyślnie instaluje skrypt $env:ProgramFiles\WindowsPowerShell\Scripts . Wymaga to konta administratora. W przypadku dodania parametru -Scope CurrentUser skrypt zostanie zainstalowany do $HOME\Documents\WindowsPowerShell\Scripts programu .

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

Wdróż

Aby wdrożyć pakiet z Galeria programu PowerShell do Azure Automation, kliknij przycisk Azure Automation, a następnie kliknij pozycję Wdróż, aby Azure Automation na stronie szczegółów pakietu. Nastąpi przekierowanie do portalu zarządzania 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 wdraża wszystkie zależności w Azure Automation. Przycisk "Wdróż w Azure Automation" można wyłączyć, dodając tag AzureAutomationNotSupported do metadanych pakietu.

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

Aby zaktualizować pakiety zainstalowane z Galeria programu PowerShell, uruchom Update-Module polecenie cmdlet lub Update-Script . Po uruchomieniu bez żadnych dodatkowych parametrów Update-Module próbuje zaktualizować wszystkie moduły zainstalowane przez uruchomienie polecenia Install-Module. Aby selektywnie aktualizować moduły, dodaj -Name parametr .

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

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

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

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:

  • onegetcdn.azureedge.net - Nazwa hosta usługi CDN

Hosty wymagane podczas korzystania z witryny internetowej Galeria programu PowerShell:

  • devopsgallerystorage.blob.core.windows.net — nazwa hosta konta magazynu
  • *.powershellgallery.com -Stronie internetowej
  • go.microsoft.com - usługa przekierowania

Ważne

Od kwietnia 2020 r. Galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Jeśli nie używasz protokołu TLS 1.2 lub nowszego, podczas próby uzyskania dostępu do Galeria 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

Aby uzyskać więcej informacji, zobacz ogłoszenie w blogu programu PowerShell.