Edit

Troubleshooting cmdlets

  • Article

How to resolve "WARNING: Package 'your package name' failed to download" issue

It is reported that Install-Module or Update-Module sometimes fails on some machines. Based on our investigation, it is something to do with the networking connection. Recently we updated NuGet provider so that it can reliably download packages. You can follow the instructions below to install the latest build of NuGet provider and then install or update your module. Let's use 'Azure' module as an example below.

Install-PackageProvider NuGet -MinimumVersion 2.8.5.206 -Force
Launch new PowerShell Console
Update-Module Azure -Verbose

Required network endpoints

The Install and Update cmdlets require internet access to connect to the network endpoints used by the PowerShell Gallery. Ensure that your network access policies allow you to connect to the following endpoints.

Hosts required for package discovery and download:

  • onegetcdn.azureedge.net - CDN hostname
  • psg-prod-centralus.azureedge.net - CDN hostname
  • psg-prod-eastus.azureedge.net - CDN hostname
  • az818661.vo.msecnd.net - CDN hostname

Note

The CDN for the PowerShell gallery is active for one name, psg-prod-eastus.azureedge.net or psg-prod-centralus.azureedge.net, at any given time. The inactive name becomes the valid, active name if there is a need to failover the service. Therefore, both names should be included in your allow lists.

Hosts required when using the PowerShell Gallery website:

  • devopsgallerystorage.blob.core.windows.net - storage account hostname
  • *.powershellgallery.com - website
  • go.microsoft.com - redirection service

Note

Cmdlets that interact with the PowerShell Gallery can fail with unexpected errors when there is an outage of the PowerShell Gallery services. To see the current status of the PowerShell Gallery, see the PowerShell Gallery Status page on GitHub.