<< All versions
Skill v1.0.0
currentTrusted Publisher100/100microsoft/azure-skills/azure-search-nav
──Details
PublishedOctober 11, 2026 at 01:20 AM
Content Hashsha256:34f91a2e0e995e55...
Git SHA
──Files
Files (1 file, 2.4 KB)
SKILL.md2.4 KBactive
SKILL.md · 48 lines · 2.4 KB
version: "1.0.0" name: azure-search-nav description: "Builds an Azure portal deep link to a specific blade/menu item for supported Microsoft.ContainerService, Microsoft.Kubernetes, and Microsoft.Compute resources using the aks-search-direct-mid semantic search API. WHEN: 'find where in the Azure portal to do something', 'search the portal for an operation', 'construct a portal link from a search query and a resource'." license: MIT metadata: author: Microsoft version: "1.0.1"
Azure 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 at https://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 |