About azure-search-nav
A skill that builds Azure Portal navigation links from a resource URL or ARM resource ID and a search query. It uses PowerShell with Az.Accounts authentication to find matching portal blades for supported resource types.
Key features
- 01Accept portal URLs or ARM resource IDs
- 02Search Azure Portal navigation items
- 03Authenticate with browser or device code
- 04Return portal deep links
- 05Support configured resource types
Use cases
- 01Find a blade for a supported Azure resource
- 02Locate a portal menu for an operation
- 03Create a deep link from an ARM resource ID
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ microsoft/ azure-skills --skill azure-search-navAfter installing, type/azure-search-navin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/Invoke-PortalSearchNav.ps1README.mdresource-types.jsonDetails
From the project READMEAzure Portal Search Link Builder
Quick Reference
| Item | Value |
|---|---|
| Script | references/Invoke-PortalSearchNav.ps1 |
| Resource map | references/resource-types.json |
| Prerequisite | Az.Accounts PowerShell module |
| Auth | Interactive Microsoft sign-in (Connect-AzAccount), or device-code with -UseDeviceAuthentication |
When to Use This Skill
- User asks to find where in the Azure portal to perform an operation on a supported Container Service, Arc-enabled Kubernetes, or Compute resource.
- User wants a portal deep link for a specific blade/menu item.
- User provides a resource URL or ARM resource ID and a natural-language search query.
Workflow
- Collect resource link (portal URL or bare ARM resource ID) and search query from the user.
- Run
references/Invoke-PortalSearchNav.ps1 -ResourceUrl '<link>' -Query '<query>'. - The script signs in (browser by default; pass
-UseDeviceAuthenticationin headless/CLI environments), calls the search API, and prints portal deep links always rooted athttps://portal.azure.com.
See references/README.md for full parameter reference and API details.
Error Handling
| Error | Cause | Fix |
|---|---|---|
| Resource type not enabled | armProvider not in references/resource-types.json | Confirm the type is in the enabled-provider list |
| 401 from API | Invalid token, or wrong tenant selected | Re-run and select the account with access to the target subscription's tenant |
| Empty results | No matching navigation item for the query | Try a different search term |
Az.Accounts not found | Module not installed | Install-Module Az.Accounts -Scope CurrentUser |
| Browser sign-in fails (no window handle) | Headless/CLI environment | Re-run with -UseDeviceAuthentication |
Comments
Markdown supported