Partilhar via

Introdução à Galeria do PowerShell

  • Artigo

A Galeria do PowerShell é um repositório de pacotes que contém scripts, módulos e recursos DSC que você pode baixar e aproveitar. Use 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.

Observação

É possível baixar um pacote diretamente da Galeria do PowerShell, mas essa não é uma abordagem recomendada. Para obter mais detalhes, consulte Download Manual de Pacotes.

Você pode encontrar pacotes na Galeria do PowerShell usando o controle de de Pesquisa de na home page da Galeria do PowerShell, ou navegando pelos Módulos e Scripts da página Pacotes de . Você também pode encontrar pacotes na 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:

  • Designação
  • Todas as versões
  • Versão Mínima
  • Versão Necessária
  • Etiqueta
  • Inclui
  • DscResource
  • RoleCapability
  • Comando
  • Filtrar

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

Depois de identificar um pacote em que está interessado, convém saber mais sobre ele. Você pode fazer isso examinando a página específica desse pacote na Galeria. Nessa página, você poderá ver todos os metadados carregados com o pacote. Esses metadados são fornecidos pelo autor do pacote e não são verificados pela Microsoft. O Proprietário do pacote está fortemente vinculado à conta da Galeria usada para publicar o pacote e é mais confiável do que o campo Autor.

Se você descobrir um pacote que você acha que não foi publicado de boa fé, clique em 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 Gallery.

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

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

Inspecionar

Para baixar um pacote da Galeria para inspeção, execute o cmdlet Save-Module ou Save-Script, dependendo do tipo de pacote. Isso permite que você salve o pacote localmente sem instalá-lo e inspecione o conteúdo do pacote. Lembre-se de excluir o pacote salvo manualmente.

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

Se você descobrir um pacote que você acha que não foi publicado de boa fé, clique em 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.

Install-Module instala o módulo para $env:ProgramFiles\WindowsPowerShell\Modules por padrão. Isso requer uma conta de administrador. Se você adicionar o parâmetro -Scope CurrentUser, o módulo será instalado no $HOME\Documents\WindowsPowerShell\Modules .

Install-Script instala o script para $env:ProgramFiles\WindowsPowerShell\Scripts por padrão. Isso requer uma conta de administrador. Se você adicionar o parâmetro -Scope CurrentUser, o script será instalado no $HOME\Documents\WindowsPowerShell\Scripts .

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

Implantar

Para implantar um pacote da Galeria do PowerShell na Automação do Azure, clique em de Automação do Azure e, em seguida, clique em Implantar na Automação do Azure na página de detalhes do pacote. Você será redirecionado para o Portal de Gerenciamento do Azure onde entrará usando suas credenciais de conta do Azure. Observe que a implantação de pacotes com dependências implanta todas as dependências na Automação do Azure. O botão 'Implantar na Automação do Azure' pode ser desabilitado adicionando a marca AzureAutomationNotSupported aos metadados do pacote.

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

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

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

Para descobrir quais módulos você instalou a partir da Galeria do PowerShell, execute o cmdlet Get-InstalledModule. 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 do PowerShell, execute o cmdlet Get-InstalledScript. Este comando lista todos os scripts que você tem em seu sistema que foram instalados diretamente da Galeria do PowerShell.

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

Hosts necessários para descoberta e download de pacotes:

  • onegetcdn.azureedge.net
  • powershellgallery.azureedge.net
  • psg-prod-eastus.azureedge.net

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

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

Importante

A partir de abril de 2020, a Galeria do PowerShell não suporta mais as versões 1.0 e 1.1 do Transport Layer Security (TLS). 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

Para obter mais informações, consulte o de anúncio de no blog do PowerShell.