Rozpoczęcie korzystania z galerii programu PowerShellGetting Started with the PowerShell Gallery

Właściwy sposób, aby zainstalować pakiety z galerii programu PowerShell jest użycie polecenia cmdlet w PowerShellGet modułu.The proper way to install packages from the PowerShell Gallery is to use the cmdlets in the PowerShellGet module. Nie musisz zalogować się do pobierania elementów z galerii programu PowerShell.You do not need to sign in to download items from the PowerShell Gallery.

Uwaga

Istnieje możliwość pobrania pakietu z galerii programu PowerShell bezpośrednio, ale nie jest to zalecane podejście.It is possible to download a package from the PowerShell Gallery directly, but this is not a recommended approach. Aby uzyskać więcej informacji, zobacz Pobieranie pakietu ręczne.For more details, see Manual Package Download.

Pakietów można znaleźć w galerii programu PowerShell, za pomocą wyszukiwania kontroli w tej witrynie internetowej lub przeglądania stron modułów i skryptów.You can find packages in the PowerShell Gallery by using the Search control on this website, or by browsing through the Modules and Scripts pages. Można również wyszukiwać pakiety z galerii programu PowerShell, uruchamiając Find-Module i Find-Script poleceń cmdlet, w zależności od typu elementu z -Repository PSGallery.You can also find packages from the PowerShell Gallery by running the Find-Module and Find-Script cmdlets, depending on the item type, with -Repository PSGallery.

Filtrowanie wyników za pomocą galerii może odbywać się przy użyciu następujących parametrów:Filtering results from the Gallery can be done by using the following parameters:

  • NazwaName
  • AllVersionsAllVersions
  • MinimumVersionMinimumVersion
  • RequiredVersionRequiredVersion
  • TagTag
  • ZawieraIncludes
  • DscResourceDscResource
  • RoleCapabilityRoleCapability
  • PolecenieCommand
  • FiltrFilter

Jeśli interesuje Cię tylko odnajdywanie określone zasoby DSC w galerii, możesz uruchomić Find-DscResource polecenia cmdlet.If you're only interested in discovering specific DSC resources in the Gallery, you can run the Find-DscResource cmdlet. Znajdź-DscResource zwraca dane dla zasobów DSC znajdujących się w galerii.Find-DscResource returns data on DSC resources contained in the Gallery. Ponieważ zasoby DSC zawsze są dostarczane jako część modułu, nadal musisz uruchomić Install-Module do zainstalowania tych zasobów DSC.Because DSC resources are always delivered as part of a module, you still need to run Install-Module to install those DSC resources.

Po zidentyfikowaniu pakietu, który chcesz wziąć można dowiedzieć się więcej na ten temat.Once you've identified a package that you're interested in, you may want to learn more about it. Można to zrobić, sprawdzając tego pakietu w określonej strony w galerii.You can do this by examining that package's specific page on the Gallery. Na tej stronie można będzie wyświetlić wszystkie metadane zostały przesłane z pakietu.On that page, you'll be able to see all of the metadata uploaded with the package. Te metadane są dostarczane przez autora pakietu, a nie został zweryfikowany przez firmę Microsoft.This metadata is provided by the package's author, and is not verified by Microsoft. Właściciel pakietu jest ściśle powiązane konto galerii, używane do opublikowania pakietu i jest bardziej wiarygodne niż pola Autor.The Owner of the package is strongly tied to the Gallery account used to publish the package, and is more trustworthy than the Author field.

Jeśli użytkownik zauważy, pakietów, które uważasz, że nie został opublikowany w dobrej wierze, kliknij przycisk Zgłoś nadużycie na stronie tego pakietu.If you discover a package that you feel is not published in good faith, click Report Abuse on that package's page.

Jeśli korzystasz z Find-Module lub Find-Script, dane te można wyświetlić w zwracany obiekt PSGetModuleInfo.If you're running Find-Module or Find-Script, you can view this data in the returned PSGetModuleInfo object. Na przykład uruchomiony Find-Module -Name PSReadLine -Repository PSGallery |Get-MemberFor example, running Find-Module -Name PSReadLine -Repository PSGallery |Get-Member Zwraca dane na temat modułu PSReadLine w galerii.returns data on the PSReadLine module in the Gallery.

Firma Microsoft zachęca następujący proces pobierania pakietów z galerii programu PowerShell:We encourage the following process when downloading packages from the PowerShell Gallery:

SprawdzanieInspect

Aby pobrać pakiet z galerii w celu przeprowadzenia inspekcji, uruchom Save-Module lub Save-Script polecenia cmdlet, w zależności od typu pakietu.To download a package from the Gallery for inspection, run either the Save-Module or Save-Script cmdlet, depending on the package type. Dzięki temu można zapisać pakiet lokalnie bez instalowania i sprawdź zawartość pakietu.This lets you save the package locally without installing it, and inspect the package contents. Pamiętaj, aby ręcznie usunąć zapisanego pakietu.Remember to delete the saved package manually.

Niektóre z tych pakietów są tworzone przez firmę Microsoft, a inne są tworzone przez społeczność użytkowników programu PowerShell.Some of these packages are authored by Microsoft, and others are authored by the PowerShell community. Firma Microsoft zaleca przejrzenie treści i kodu pakietów w tej galerii, przed instalacją.Microsoft recommends that you review the contents and code of packages on this gallery prior to installation.

Jeśli użytkownik zauważy, pakietów, które uważasz, że nie został opublikowany w dobrej wierze, kliknij przycisk Zgłoś nadużycie na stronie tego pakietu.If you discover a package that you feel is not published in good faith, click Report Abuse on that package's page.

Instalowanie w klastrze zarządzania systemuInstall

Aby zainstalować pakiet z galerii do użycia, uruchom Install-Module lub Install-Script polecenia cmdlet, w zależności od typu pakietu.To install a package from the Gallery for use, run either the Install-Module or Install-Script cmdlet, depending on the package type.

Install-Module instaluje moduł do $env:ProgramFiles\WindowsPowerShell\Modules domyślnie.Install-Module installs the module to $env:ProgramFiles\WindowsPowerShell\Modules by default. Wymaga to konto administratora.This requires an administrator account. Jeśli dodasz -Scope CurrentUser parametru moduł jest zainstalowany na $env:USERPROFILE\Documents\WindowsPowerShell\Modules .If you add the -Scope CurrentUser parameter, the module is installed to $env:USERPROFILE\Documents\WindowsPowerShell\Modules .

Install-Script instaluje skrypt, aby $env:ProgramFiles\WindowsPowerShell\Scripts domyślnie.Install-Script installs the script to $env:ProgramFiles\WindowsPowerShell\Scripts by default. Wymaga to konto administratora.This requires an administrator account. Jeśli dodasz -Scope CurrentUser parametru skryptu jest instalowana na $env:USERPROFILE\Documents\WindowsPowerShell\Scripts .If you add the -Scope CurrentUser parameter, the script is installed to $env:USERPROFILE\Documents\WindowsPowerShell\Scripts .

Domyślnie Install-Module i Install-Script instaluje najnowszą wersję pakietu.By default, Install-Module and Install-Script installs the most current version of a package. Aby zainstalować starszą wersję pakietu, Dodaj -RequiredVersion parametru.To install an older version of the package, add the -RequiredVersion parameter.

Wdróż programDeploy

Aby wdrożyć pakiet z galerii programu PowerShell w usłudze Azure Automation, kliknij przycisk wdrażanie w usłudze Azure Automation na stronie szczegółów pakietu.To deploy a package from the PowerShell Gallery to Azure Automation, click Deploy to Azure Automation on the package details page. Nastąpi przekierowanie do portalu zarządzania systemu Azure, w którym możesz logować się przy użyciu poświadczeń konta platformy Azure.You will be redirected to the Azure Management Portal where you sign in by using your Azure account credentials. Należy pamiętać, że wdrażanie pakietów z zależnościami wdroży wszystkie zależności do usługi Azure Automation.Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Można wyłączyć przez dodanie przycisku "Wdroż do usługi Azure Automation" AzureAutomationNotSupported tagu metadanych pakietu.The 'Deploy to Azure Automation' button can be disabled by adding the AzureAutomationNotSupported tag to your package metadata.

Aby dowiedzieć się więcej o usłudze Azure Automation, zobacz usługi Azure Automation dokumentacji.To learn more about Azure Automation, see the Azure Automation documentation.

Aby zaktualizować pakiety zainstalowany z galerii programu PowerShell, uruchom [Update-Module] [] lub polecenia cmdlet [] [skrypt aktualizacji].To update packages installed from the PowerShell Gallery, run either the [Update-Module][] or [Update-Script][] cmdlet. Po uruchomieniu bez żadnych dodatkowych parametrów [] [Update-Module] próby uaktualnienia każdy moduł zainstalowane, uruchamiając Install-Module.When run without any additional parameters, [Update-Module][] attempts to update each module installed by running Install-Module. Aby selektywnie aktualizowanie modułów, należy dodać -Name parametru.To selectively update modules, add the -Name parameter.

Podobnie, gdy są uruchomione bez żadnych dodatkowych parametrów, [] [skrypt aktualizacji] również próby uaktualnienia każdego skryptu zainstalowane, uruchamiając Install-Script.Similarly, when run without any additional parameters, [Update-Script][] also attempts to update each script installed by running Install-Script. Aby selektywnie zaktualizować skrypty, Dodaj -Name parametru.To selectively update scripts, add the -Name parameter.

Aby dowiedzieć się, które moduły mają zainstalowany z galerii programu PowerShell, uruchom Get-InstalledModule polecenia cmdlet.To find out which modules you have installed from the PowerShell Gallery, run the Get-InstalledModule cmdlet. To polecenie wyświetla wszystkie moduły, które znajdują się w systemie i zainstalowanych bezpośrednio z galerii programu PowerShell.This command lists all of the modules you have on your system that were installed directly from the PowerShell Gallery.

Podobnie, aby dowiedzieć się, skrypty, które mają zainstalowany z galerii programu PowerShell, uruchom Get-InstalledScript polecenia cmdlet.Similarly, to find out which scripts you have installed from the PowerShell Gallery, run the Get-InstalledScript cmdlet. To polecenie wyświetla wszystkie skrypty, które znajdują się w systemie i zainstalowanych bezpośrednio z galerii programu PowerShell.This command lists all of the scripts you have on your system that were installed directly from the PowerShell Gallery.