Add actionable guidance for PowerShell hook failures#6804
Open
spboyer wants to merge 1 commit intoAzure:mainfrom
Open
Add actionable guidance for PowerShell hook failures#6804spboyer wants to merge 1 commit intoAzure:mainfrom
spboyer wants to merge 1 commit intoAzure:mainfrom
Conversation
spboyer
requested review from
JeffreyCA,
hemarina,
rajeshkamal5050,
tg-msft,
vhvb1989,
wbreza and
weikanglim
as code owners
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds actionable guidance for PowerShell hook failures by detecting common error patterns in stderr output and displaying targeted hints to help users resolve issues. This addresses issue #6797, which identified PowerShell hook failures as the 4th largest error category (~6,347 errors, 4.96% of all azd errors).
Changes:
- Added
pwshFailureGuidance()function inerror.gothat detects 5 common PowerShell failure patterns - Created comprehensive table-driven tests in
pwsh_guidance_test.goto cover all patterns - Added
StderrOutput()getter andNewTestExitError()test helper toExitErrortype inrunresult.go
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 6 comments.
| File | Description |
|---|---|
| cli/azd/pkg/exec/runresult.go | Adds StderrOutput() accessor and NewTestExitError() test constructor to ExitError for easier testing |
| cli/azd/cmd/middleware/pwsh_guidance_test.go | Comprehensive table-driven tests covering all 5 PowerShell failure patterns plus edge cases |
| cli/azd/cmd/middleware/error.go | Implements pwshFailureGuidance() to detect common PowerShell errors and integrated hint display in ErrorMiddleware |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
spboyer
force-pushed
the
fix/pwsh-hook-guidance
branch
from
3506da2 to
e6e5036
Compare
spboyer
requested review from
achauhan-scc,
kingernupur,
rabollin,
saanikaguptamicrosoft and
trangevi
as code owners
When PowerShell hooks fail, detect common failure patterns in stderr output and display targeted hints to help users resolve the issue. Patterns detected include missing modules, Az module not found, execution policy restrictions, and expired authentication. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
spboyer
force-pushed
the
fix/pwsh-hook-guidance
branch
from
e6e5036 to
22fb706
Compare
Collaborator
Azure Dev CLI Install InstructionsInstall scriptsMacOS/Linux
bash: pwsh: WindowsPowerShell install MSI install Standalone Binary
MSI
Documentationlearn.microsoft.com documentationtitle: Azure Developer CLI reference
|
vhvb1989
approved these changes
Feb 19, 2026
Member
vhvb1989
left a comment
vhvb1989
left a comment
There was a problem hiding this comment.
Let's hope 🤞 we don't get many false-positives for all those string.contains()
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
When PowerShell hooks fail, detects common failure patterns in stderr output and displays targeted hints to help users resolve the issue.
Fixes #6797
Changes
error.go
pwsh_guidance_test.go (new)
runresult.go
Data Context
PowerShell hook failures account for 4.96% of all azd errors (~6,347). AI templates hit 6.59%.