Compartilhar via

Introdução à Galeria do PowerShell

A PowerShell Gallery é um repositório de pacotes que contém scripts, módulos e recursos DSC que você pode baixar e usar. Você usa os cmdlets no módulo PowerShellGet para instalar pacotes da Galeria do PowerShell. Você não precisa entrar para baixar itens da Galeria do PowerShell.

Você pode encontrar pacotes na Galeria do PowerShell usando o controle Pesquisar na página inicial da Galeria do PowerShellou navegando pelos Módulos e Scripts da página Pacotes. Você também pode encontrar pacotes da Galeria do PowerShell executando os cmdlets Find-Module, Find-DscResourcee Find-Script, dependendo do tipo de pacote, com -Repository PSGallery.

Você pode filtrar os resultados da Galeria usando os seguintes parâmetros:

  • Nome
  • AllVersions
  • MinimumVersion
  • RequiredVersion
  • Etiqueta
  • Inclui
  • DscResource
  • RoleCapability
  • Comando
  • Filtro

Se você estiver interessado apenas em descobrir recursos específicos de DSC na Galeria, poderá executar o cmdlet Find-DscResource. Find-DscResource retorna dados sobre os recursos DSC contidos na Galeria. Como os recursos de DSC são sempre entregues como parte de um módulo, você ainda precisa executar Install-Module para instalar esses recursos de DSC.

Depois de escolher um pacote, talvez queira saber mais sobre ele. Consulte a página do pacote na Galeria. A página do pacote inclui os metadados enviados junto com o pacote. Os metadados são fornecidos pelo autor do pacote. A Microsoft não verifica essas informações. O Proprietário do pacote está associado à conta da Galeria usada para publicar o pacote. A conta do Proprietário é mais autoritária do que o campo Autor.

Se você descobrir um pacote que acha que não foi publicado de boa-fé, selecione Denunciar Abuso na página desse pacote.

Se você estiver executando ou , poderá exibir esses dados no objeto PSGetModuleInfo retornado. O exemplo a seguir retorna dados no módulo PSReadLine na Galeria.

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

Incentivamos o seguinte processo ao baixar pacotes da Galeria do PowerShell:

Inspecionar

Para baixar um pacote da Galeria para inspeção, use os Save-Module cmdlets de OR Save-Script no pacote. Esses comandos salvam o pacote localmente sem que ele seja instalado. Inspecione o conteúdo do pacote. Lembre-se de excluir o pacote salvo manualmente.

Alguns pacotes são criados pela Microsoft, e outros pela comunidade PowerShell. A Microsoft recomenda que você examine o conteúdo e o código dos pacotes nesta galeria antes da instalação.

Se você descobrir um pacote que acha que não foi publicado de boa-fé, selecione Denunciar Abuso na página desse pacote.

Instalar

Para instalar um pacote da Galeria para uso, execute o cmdlet Install-Module ou Install-Script, dependendo do tipo de pacote.

Por padrão, Install-Module instala o módulo na $env:ProgramFiles\WindowsPowerShell\Modules localização por padrão, o que requer uma conta de administrador. Se você adicionar o -Scope CurrentUser parâmetro, o comando instala o módulo em $HOME\Documents\WindowsPowerShell\Modules .

Por padrão, Install-Script instala o script no $env:ProgramFiles\WindowsPowerShell\Scripts local, o que requer uma conta de administrador. Se você adicionar o -Scope CurrentUser parâmetro, o comando instala o script em $HOME\Documents\WindowsPowerShell\Scripts.

Install-Module e Install-Script instala a versão mais recente de um pacote. Para instalar uma versão mais antiga do pacote, adicione o parâmetro -RequiredVersion.

Implantar

Para implantar um pacote da PowerShell Gallery para Azure Automation, selecione Azure Automation e depois selecione Implantar para Azure Automation na página de detalhes do pacote. Você é redirecionado para o Portal de Gerenciamento Azure, onde faz login usando as credenciais da sua conta Azure. Implantar pacotes com dependências libera todas as dependências para o Azure Automation. O botão Implantar no Azure Automation pode ser desativado adicionando a tag AzureAutomationNotSupported aos metadados do seu pacote.

Para saber mais sobre a Automação do Azure, consulte a documentação do de Automação do Azure.

Para atualizar os pacotes instalados da Galeria do PowerShell, execute o cmdlet Update-Module ou Update-Script. Quando executado sem outros parâmetros, Update-Module tenta atualizar todos os módulos instalados executando Install-Module. Para atualizar seletivamente os módulos, adicione o parâmetro -Name.

Da mesma forma, quando executado sem outros parâmetros, Update-Script também tenta atualizar todos os scripts instalados ao executar Install-Script. Para atualizar seletivamente scripts, adicione o parâmetro -Name.

Para descobrir quais módulos você instalou na PowerShell Gallery, execute o Get-InstalledModule cmdlet. Este comando lista todos os módulos que você tem em seu sistema que foram instalados diretamente da Galeria do PowerShell.

Da mesma forma, para descobrir quais scripts você instalou na Galeria PowerShell, execute o Get-InstalledScript cmdlet. Esse comando lista todos os scripts que você tem em seu sistema que foram instalados diretamente da Galeria do PowerShell.

Importante

A Galeria do PowerShell requer o TLS (Transport Layer Security) 1.2 ou superior. Se você não estiver usando o TLS 1.2 ou superior, receberá um erro ao tentar acessar a Galeria do PowerShell. Use o seguinte comando para garantir que você esteja usando o TLS 1.2:

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

Esses nomes de host devem ser adicionados às listas de permissão que controlam o acesso da rede.

Hosts necessários para descoberta e download do pacote:

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

Hosts necessários ao usar o site da Galeria do PowerShell:

  • *.powershellgallery.com - site
  • go.microsoft.com e aka.ms – serviços de redirecionamento

Nota

Os pontos de extremidade antigos que terminavam com azureedge.net não são mais suportados.

  • Last updated on