Introdução à Galeria do PowerShellGet Started with the PowerShell Gallery

A Galeria do PowerShell é o repositório central de conteúdo do PowerShell.The PowerShell Gallery is the central repository for PowerShell content. Nela, você pode encontrar módulos úteis do PowerShell que contêm comandos do PowerShell e recursos de DSC (Configuração de Estado Desejado).In it, you can find useful PowerShell modules containing PowerShell commands and Desired State Configuration (DSC) resources. Você também pode encontrar scripts do PowerShell, alguns dos quais podem conter fluxos de trabalho do PowerShell e que descrevem um conjunto de tarefas e fornecem o sequenciamento para essas tarefas.You can also find PowerShell scripts, some of which may contain PowerShell workflows, and which outline a set of tasks and provide sequencing for those tasks. Alguns desses itens são criados pela Microsoft e outros são criados pela comunidade do PowerShell.Some of these items are authored by Microsoft, and others are authored by the PowerShell community.

RequisitosRequirements

Baixar itens da Galeria do PowerShell para o seu sistema requer o módulo PowerShellGet.Downloading items from the PowerShell Gallery to your system requires the PowerShellGet module. Você pode encontrar o módulo PowerShellGet em qualquer um dos recursos indicados a seguir.You can find the PowerShellGet module in any of the following. Não é necessário entrar para baixar itens da Galeria do PowerShell.You do not need to sign in to download items from the PowerShell Gallery.

O PowerShellGet também requer o provedor NuGet para funcionar com a Galeria do PowerShell.PowerShellGet also requires the NuGet provider to work with the PowerShell Gallery. Você será solicitado a instalar o provedor NuGet automaticamente na primeira utilização do PowerShellGet se o provedor NuGet não estiver em um dos seguintes locais:You will be prompted to install the NuGet provider automatically upon first use of PowerShellGet if the NuGet provider is not in one of the following locations:

  • $env:ProgramFiles\PackageManagement\ProviderAssemblies
  • $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies

Ou, você pode executar Install-PackageProvider -Name NuGet -Force para automatizar o download e a instalação do provedor do NuGet.Or, you can run Install-PackageProvider -Name NuGet -Force to automate the download and installation of the NuGet provider.

Se você uma versão mais antiga que a 2.8.5.201 do NuGet, você precisará chamar os seguintes cmdlets do PowerShell para instalar e passar para a versão mais recente do NuGet.If you have a version older than 2.8.5.201 of NuGet, you will need to call the following PowerShell cmdlets to install and switch to the latest version of NuGet.

  1. Install-PackageProvider NuGet -MinimumVersion '2.8.5.201' -Force
  2. Import-PackageProvider NuGet -MinimumVersion '2.8.5.201' -Force
  3. Exclua a versão mais antiga do NuGet do local instalado acima.Delete the older version of NuGet from the above installed location.

Para obter mais informações, consulte http://oneget.org/.For more information, see http://oneget.org/ .

Observação: devido a alterações nos formatos de empacotamento, é recomendável atualizar para a versão mais recente do PowerShellGet e do PackageManagement para instalar itens que foram atualizados recentemente.Note: Due to changes in packaging formats, we recommend you update to the latest version of PowerShellGet and PackageManagement to install items that have been updated recently. O PowerShellGet está incluído no Windows 10; você pode aprender mais sobre ele aqui.PowerShellGet is included in Windows 10, which you can learn more about here. O PowerShellGet também faz parte do WMF (Windows Management Framework) 5.0, que você pode baixar aqui.PowerShellGet is also part of the Windows Management Framework (WMF) 5.0, which you can download here.

Você pode encontrar itens na Galeria do PowerShell usando o controle Pesquisar no site ou navegando pelas páginas de Módulos e Scripts.You can find items in the PowerShell Gallery by using the Search control on this website, or by browsing through the Modules and Scripts pages. Você pode também encontrar itens da Galeria do PowerShell executando os cmdlets Find-Module e Find-Script, dependendo do tipo de item, com -Repository PSGallery.You can also find items from the PowerShell Gallery by running the Find-Module and Find-Script cmdlets, depending on the item type, with -Repository PSGallery.

A filtragem de resultados da Galeria pode ser feita usando os seguintes parâmetros de Find-Module e Find-ScriptFiltering results from the Gallery can be done by using the following parameters of Find-Module and Find-Script

  • NomeName
  • AllVersionsAllVersions
  • MinimumVersionMinimumVersion
  • RequiredVersionRequiredVersion
  • TagTag
  • IncludesIncludes
  • DscResourceDscResource
  • RoleCapabilityRoleCapability
  • ComandoCommand
  • FiltroFilter

Caso tenha interesse apenas em descobrir recursos de DSC específicos na Galeria, execute o cmdlet Find-DscResource.If you're only interested in discovering specific DSC resources in the Gallery, you can run the Find-DscResource cmdlet. Find-DscResource retorna dados sobre recursos de DSC incluídos na Galeria.Find-DscResource returns data on DSC resources contained in the Gallery. Como os recursos de DSC sempre são fornecidos como parte de um módulo, você ainda precisa executar Install-Module para instalar esses recursos.Because DSC resources are always delivered as part of a module, you still need to run Install-Module to install those DSC resources.

Depois de identificar um item no qual tem interesse, talvez você queira aprender mais sobre ele.Once you've identified an item you're interested in, you may want to learn more about it. Você pode fazer isso examinando a página específica do item na Galeria.You can do this by examining that item's specific page on the Gallery. Nessa página, você poderá ver todos os metadados carregados com o item.On that page, you'll be able to see all of the metadata uploaded with the item. Esses metadados do item são fornecidos pelo autor do item e não são verificados pela Microsoft.This metadata for an item is provided by the item's author, and is not verified by Microsoft. O Proprietário do item está intimamente ligado à conta da Galeria usada para publicar o item e é mais confiável do que o campo Autor.The Owner of the item is strongly tied to the Gallery account used to publish the item, and is more trustworthy than the Author field.

Se você descobrir que um item que acredita que não tenha sido publicado de boa fé, clique em Relatar Abuso na página do item.If you discover an item that you feel is not published in good faith, click Report Abuse on that item's page.

Se estiver executando Find-Module ou Find-Script, você poderá exibir esses dados no objeto PSGetModuleInfo retornado.If you're running Find-Module or Find-Script, you can view this data in the returned PSGetModuleInfo object. Por exemplo, executar Find-Module -Name PSReadLine -Repository PSGallery | Get-Member retorna dados sobre o módulo PSReadLine na Galeria.For example, running Find-Module -Name PSReadLine -Repository PSGallery | Get-Member returns data on the PSReadLine module in the Gallery.

Recomendamos o processo a seguir para baixar itens da Galeria do PowerShell:We encourage the following process when downloading items from the PowerShell Gallery:

InspecionarInspect

Para baixar um item da Galeria para inspeção, execute o cmdlet Save-Module ou Save-Script, dependendo do tipo de item.To download an item from the Gallery for inspection, run either the Save-Module or Save-Script cmdlet, depending on the item type. Isso permite que você salve o item localmente sem instalá-lo e inspecione o conteúdo do item.This lets you save the item locally without installing it, and inspect the item contents. Lembre-se de excluir o item salvo manualmente.Remember to delete the saved item manually.

Alguns desses itens são criados pela Microsoft e outros são criados pela comunidade do PowerShell.Some of these items are authored by Microsoft, and others are authored by the PowerShell community. A Microsoft recomenda que você examine o conteúdo e o código dos itens nesta galeria antes da instalação.Microsoft recommends that you review the contents and code of items on this gallery prior to installation.

Se você descobrir que um item que acredita que não tenha sido publicado de boa fé, clique em Relatar Abuso na página do item.If you discover an item that you feel is not published in good faith, click Report Abuse on that item's page.

InstalarInstall

Para instalar um item da Galeria para uso, execute o cmdlet Install-Module ou Install-Script, dependendo do tipo de item.To install an item from the Gallery for use, run either the Install-Module or Install-Script cmdlet, depending on the item type.

Install-Module instala o módulo em $env:ProgramFiles\WindowsPowerShell\Modules por padrão.Install-Module installs the module to $env:ProgramFiles\WindowsPowerShell\Modules by default. Isso requer uma conta de administrador.This requires an administrator account. Se você adicionar o parâmetro -Scope CurrentUser, o módulo será instalado em $env:USERPROFILE\Documents\WindowsPowerShell\Modules.If you add the -Scope CurrentUser parameter, the module is installed to $env:USERPROFILE\Documents\WindowsPowerShell\Modules .

Install-Script instala o script em $env:ProgramFiles\WindowsPowerShell\Scripts por padrão.Install-Script installs the script to $env:ProgramFiles\WindowsPowerShell\Scripts by default. Isso requer uma conta de administrador.This requires an administrator account. Se você adicionar o parâmetro -Scope CurrentUser, o script será instalado em $env:USERPROFILE\Documents\WindowsPowerShell\Scripts.If you add the -Scope CurrentUser parameter, the script is installed to $env:USERPROFILE\Documents\WindowsPowerShell\Scripts .

Por padrão, Install-Module e Install-Script instalam a versão mais recente de um item.By default, Install-Module and Install-Script installs the most current version of an item. Para instalar uma versão mais antiga do item, adicione o parâmetro -RequiredVersion.To install an older version of the item, add the -RequiredVersion parameter.

ImplantarDeploy

Para implantar um item da Galeria do PowerShell na Automação do Azure, clique em Implantar na Automação do Azure na página de detalhes do item.To deploy an item from the PowerShell Gallery to Azure Automation, click Deploy to Azure Automation on the item details page. Você será redirecionado ao Portal de Gerenciamento do Azure, em que você entra usando as credenciais de sua conta do Azure.You will be redirected to the Azure Management Portal, where you sign in by using your Azure account credentials. Observe que implantar itens com dependências implantará todas as dependências na Automação do Azure.Note that deploying items with dependencies will deploy all the dependencies to Azure Automation. O botão Implantar na Automação do Azure pode ser desabilitado adicionando a marca AzureAutomationNotSupported aos metadados do item.The 'Deploy to Azure Automation' button can be disabled by adding the AzureAutomationNotSupported tag to your item metadata.

Para saber mais sobre a Automação do Azure, consulte o Site da Automação do Azure.To learn more about Azure Automation, see the Azure Automation website.

Para atualizar itens instalados da Galeria do PowerShell, execute o cmdlet Update-Module ou Update-Script.To update items installed from the PowerShell Gallery, run either the Update-Module or Update-Script cmdlet. Quando executado sem parâmetros adicionais, Update-Module também tenta atualizar cada módulo instalado executando Install-Module.When run without any additional parameters, Update-Module attempts to update each module installed by running Install-Module. Para atualizar os módulos seletivamente, adicione o parâmetro -Name.To selectively update modules, add the -Name parameter.

De forma semelhante, quando executado sem parâmetros adicionais, Update-Script também tenta atualizar cada script instalado executando Install-Script.Similarly, when run without any additional parameters, Update-Script also attempts to update each script installed by running Install-Script. Para atualizar os scripts seletivamente, adicione o parâmetro -Name.To selectively update scripts, add the -Name parameter.

Para descobrir quais módulos você instalou da Galeria do PowerShell, execute o cmdlet Get-InstalledModule.To find out which modules you have installed from the PowerShell Gallery, run the Get-InstalledModule cmdlet. Esse comando lista todos os módulos no seu sistema que foram instalados diretamente da Galeria do PowerShell.This command lists all of the modules you have on your system that were installed directly from the PowerShell Gallery.

De forma semelhante, para descobrir quais scripts você instalou da Galeria do PowerShell, execute o cmdlet Get-InstalledScript.Similarly, to find out which scripts you have installed from the PowerShell Gallery, run the Get-InstalledScript cmdlet. Esse comando lista todos os scripts no seu sistema que foram instalados diretamente da Galeria do PowerShell.This command lists all of the scripts you have on your system that were installed directly from the PowerShell Gallery.