|
1 | 1 | --- |
2 | 2 | description: This article provide information and steps for troubleshooting errors using the PowerShell Gallery |
3 | | -ms.date: 06/12/2025 |
| 3 | +ms.date: 09/09/2025 |
4 | 4 | title: Troubleshooting cmdlets |
5 | 5 | --- |
6 | 6 | # Troubleshooting cmdlets |
7 | 7 |
|
8 | 8 | ## How to resolve "WARNING: Package 'your package name' failed to download" issue |
9 | 9 |
|
10 | | -It is reported that `Install-Module` or `Update-Module` sometimes fails on some machines. Based on |
11 | | -our investigation, it is something to do with the networking connection. Recently we updated NuGet |
12 | | -provider so that it can reliably download packages. You can follow the instructions below to install |
13 | | -the latest build of NuGet provider and then install or update your module. Let's use 'Azure' module |
14 | | -as an example below. |
| 10 | +The `Install-Module` or `Update-Module` commands sometimes fail. Based on investigations, it's |
| 11 | +usually a networking problem. Ensure that you are using TLS 1.2 or higher and that your firewall |
| 12 | +rules allow access to the required network endpoints. |
| 13 | + |
| 14 | +[!INCLUDE [TLS 1.2 Requirement](../../../includes/tls-gallery.md)] |
| 15 | + |
| 16 | +The NuGet provider was updated to improve reliably. Use the following instructions to install the |
| 17 | +latest build of NuGet provider and then install or update your module. |
15 | 18 |
|
16 | 19 | ```powershell |
17 | 20 | Install-PackageProvider NuGet -MinimumVersion 2.8.5.206 -Force |
18 | | -Launch new PowerShell Console |
19 | | -Update-Module Azure -Verbose |
20 | 21 | ``` |
21 | 22 |
|
22 | 23 | ## Required network endpoints |
23 | 24 |
|
24 | | -The Install and Update cmdlets require internet access to connect to the network endpoints used by |
25 | | -the PowerShell Gallery. Ensure that your network access policies allow you to connect to TCP port |
26 | | -443 of the following endpoints. |
| 25 | +The `Install-*` and `Update-*` cmdlets require internet access to connect to the network endpoints |
| 26 | +used by the PowerShell Gallery. |
| 27 | + |
| 28 | +Ensure that your network access policies allow you to connect to TCP port 443 of the following |
| 29 | +endpoints. |
27 | 30 |
|
28 | 31 | Hosts required for package discovery and download: |
29 | 32 |
|
30 | | -- `cdn.oneget.org` - CDN hostname |
31 | | -- `cdn.powershellgallery.com` - CDN hostname |
| 33 | +- `cdn.oneget.org` |
| 34 | +- `cdn.powershellgallery.com` |
32 | 35 |
|
33 | 36 | Hosts required when using the PowerShell Gallery website: |
34 | 37 |
|
35 | | -- `devopsgallerystorage.blob.core.windows.net` - storage account hostname |
36 | 38 | - `*.powershellgallery.com` - website |
37 | | -- `go.microsoft.com` - redirection service |
| 39 | +- `go.microsoft.com` and `aka.ms` - redirection services |
38 | 40 |
|
39 | 41 | > [!NOTE] |
40 | | -> Cmdlets that interact with the PowerShell Gallery can fail with unexpected errors when there is an |
41 | | -> outage of the PowerShell Gallery services. To see the current status of the PowerShell Gallery, |
42 | | -> see the [PowerShell Gallery Status][01] |
43 | | -> page on GitHub. |
| 42 | +> These endpoints have changed. The old endpoints that ended with `azureedge.net` are no longer |
| 43 | +> supported. |
| 44 | +
|
| 45 | +Cmdlets that interact with the PowerShell Gallery can fail with unexpected errors when there is an |
| 46 | +outage of the PowerShell Gallery services. To see the current status of the PowerShell Gallery, see |
| 47 | +the [PowerShell Gallery Status][01] page on GitHub. |
44 | 48 |
|
45 | 49 | <!-- link references --> |
46 | 50 | [01]: https://github.com/PowerShell/PowerShellGallery/blob/master/psgallery_status.md |
0 commit comments