[alerickson]

PR Summary

When a request to the PowerShell Gallery fails with an HTTP 5xx server error, these cmdlets now add the following message to the error:

The PowerShell Gallery may be experiencing an issue. Check https://aka.ms/psgallery for the current service status.

The message appears only for requests to powershellgallery.com or its subdomains. It doesn't appear for other repositories or for other HTTP status codes.

Cmdlets affected

Cmdlet	Change
Find-PSResource	Search and metadata requests to the Gallery include the status hint after a 5xx error. A failed request now reports only the HTTP error, without an additional XML parse error.
Install-PSResource	The package download includes the status hint after a 5xx error. The extra No content was returned by repository and Response returned is null or empty errors no longer appear after a failed download.
Save-PSResource	Same as Install-PSResource.
Update-PSResource	Same as Install-PSResource.
Publish-PSResource	Push failures to the Gallery include the status hint after a 5xx error.

V2 request errors also show the full HTTP error details, including the request URL, status code, and Gallery hint, in the main error message. Before, these details were wrapped in an inner exception that PowerShell doesn't show by default.

PR Context

During a Gallery outage, users can see several unclear errors that don't identify the Gallery as the cause. They may then troubleshoot their own configuration or open issues against PSResourceGet. Pointing them to the Gallery status page and reporting one clear error for each failed request makes it easier to recognize a service-side outage.

PR Checklist

• PR has a meaningful title
  • Use the present tense and imperative mood when describing your changes
• Summarized changes
• Make sure all .h, .cpp, .cs, .ps1 and .psm1 files have the correct copyright header
• This PR is ready to merge and is not Work in Progress.
  • If the PR is work in progress, please add the prefix WIP: or [ WIP ] to the beginning of the title (the WIP bot will keep its status check at Pending while the prefix is present) and remove the prefix when the PR is ready.
• Breaking changes
  • None
  • OR
  • Documentation needed
    • Issue filed:
• User-facing changes
  • Not Applicable
  • OR
  • Documentation needed
    • Issue filed:
• Testing - New and feature
  • N/A or can only be tested interactively
  • OR
  • Make sure you've added a new test if existing tests do not effectively test the code changed
• Tooling
  • I have considered the user experience from a tooling perspective and don't believe tooling will be impacted.
  • OR
  • I have considered the user experience from a tooling perspective and enumerated concerns in the summary.

[azure-pipelines]

Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

[alerickson]

/azp run

[azure-pipelines]

Azure Pipelines:
Successfully started running 1 pipeline(s).

[Copilot]

🟡 Changes recommended

The outage test can leave the hosts file modified when it lacks a trailing newline, and Gallery 503 detection relies on English exception text, omitting status hints on localized .NET Framework installations.

2 open issues

• Extract status codes independently of localized exception text · New
• Ensure the hosts mapping starts on its own line · New

What changed in this PR

This PR improves PSResourceGet error reporting by adding a PowerShell Gallery service-status link for Gallery HTTP 5xx failures and suppressing redundant follow-up errors.

Changes:

• Adds shared status-hint helpers for V2 requests and publishing failures.
• Avoids secondary parse, not-found, and empty-content errors after request failures.
• Adds automated hint tests and a manual Gallery-outage simulator.

File	Description
test/​Test-PSGalleryOutage.ps1	Simulates Gallery failures for manual cmdlet validation.
test/​PublishPSResourceTests/​PublishPSResource.Tests.ps1	Adds Gallery status-hint tests.
src/​code/​V2ServerAPICalls.cs	Adds status hints and suppresses redundant request-failure errors.
src/​code/​Utils.cs	Adds Gallery detection and status-message helpers.
src/​code/​PublishHelper.cs	Appends status hints to publishing errors.
src/​code/​FindHelper.cs	Skips response processing after reported request errors.

_{Review effort: Balanced}

[alerickson]

/azp run

[azure-pipelines]

Azure Pipelines:
Successfully started running 1 pipeline(s).

[alerickson]

/azp run

[azure-pipelines]

Azure Pipelines:
Successfully started running 1 pipeline(s).