Compartilhar via


Solução de problemas de cmdlets

Como resolver o problema "AVISO: o pacote 'seu nome de pacote' não foi baixado"

Os Install-Module comandos or Update-Module às vezes falham. Com base em investigações, geralmente é um problema de rede. Verifique se você está usando o TLS 1.2 ou superior e se as regras de firewall permitem o acesso aos pontos de extremidade de rede necessários.

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

O provedor NuGet foi atualizado para melhorar de forma confiável. Use as instruções a seguir para instalar o build mais recente do provedor NuGet e, em seguida, instalar ou atualizar seu módulo.

Install-PackageProvider NuGet -MinimumVersion 2.8.5.206 -Force

Pontos de extremidade de rede necessários

Os Install-* cmdlets e Update-* exigem acesso à Internet para se conectar aos pontos de extremidade de rede usados pela Galeria do PowerShell.

Verifique se as políticas de acesso à rede permitem que você se conecte à porta TCP 443 dos pontos de extremidade a seguir.

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

Observação

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

Os cmdlets que interagem com a Galeria do PowerShell podem falhar com erros inesperados quando há uma interrupção dos serviços da Galeria do PowerShell. Para ver o status atual da Galeria do PowerShell, consulte a página Status da Galeria do PowerShell no GitHub.