cmdlet 疑难解答

如何解决“警告:包'你的包名称'未能下载”问题

Install-ModuleUpdate-Module命令有时会失败。 根据调查,这通常是一个网络问题。 确保您使用的是 TLS 1.2 或更高版本,并且您的防火墙规则允许访问所需的网络端点。

重要

PowerShell 库需要传输层安全性 (TLS) 1.2 或更高版本。 如果未使用 TLS 1.2 或更高版本,则在尝试访问 PowerShell 库时将收到错误。 使用以下命令确保您使用的是 TLS 1.2:

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

NuGet 提供程序已更新,以可靠地改进。 使用以下说明安装最新版本的 NuGet 提供程序,然后安装或更新模块。

Install-PackageProvider NuGet -MinimumVersion 2.8.5.206 -Force

所需的网络终结点

Install-*Update-* cmdlet 需要 Internet 访问权限才能连接到 PowerShell 库使用的网络终结点。

确保网络访问策略允许连接到以下终结点的 TCP 端口 443。

包发现和下载所需的主机:

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

使用 PowerShell 库网站时所需的主机:

  • *.powershellgallery.com - 网站
  • go.microsoft.comaka.ms - 重定向服务

注释

这些端点已更改。 不再支持以 结尾的 azureedge.net 旧终结点。

当 PowerShell 库服务中断时,与 PowerShell 库交互的 Cmdlet 可能会失败并出现意外错误。 若要查看 PowerShell 库的当前状态,请参阅 GitHub 上的 PowerShell 库状态 页。