Construire un lien profond vers un écran du portail Azure

Ce que ça fait

• Appeler l’API de recherche sémantique `aks-search-direct-mid` via le script PowerShell `Invoke-PortalSearchNav.ps1`, à partir d’une URL de ressource ou d’un identifiant ARM et d’une requête en langage naturel, et produire des liens toujours enracinés à `https://portal.azure.com`.
• Le module `Az.Accounts` est requis.
• L’authentification se fait par `Connect-AzAccount`, ou par code d’appareil avec `-UseDeviceAuthentication` en environnement sans navigateur.
• Ce n’est pas un moteur de recherche général du portail hors de ces fournisseurs activés.
• Le client documenté est `ContainerService`.

Pour qui, et un exemple

Quelqu’un qui cherche, pour une ressource Container Service, Kubernetes (Arc) ou Compute, où se trouve une opération dans le portail, et veut le lien profond correspondant.

On s’en sert pour trouver une lame du portail, ou construire un lien profond, pour une ressource Container Service, Kubernetes ou Compute, à partir d’une URL ou d’un identifiant ARM et d’une requête. Exemple rédigé par iadujour.fr à partir du SKILL.md, non testé.

Installer

npx skills add microsoft/skills (sélection de la skill dans l’assistant, README).

Fonctionne avec

• GitHub Copilot
• Copilot CLI

Source : README : exemples de « Copilot CLI » et « GitHub Copilot in VS Code » ; l’installation `npx skills add` envoie les fichiers vers le répertoire de l’agent choisi, sans liste exhaustive.

Niveau : Intermédiaire

À savoir

Extrait du SKILL.md

La description d’origine, celle que l’agent lit pour décider de charger la skill (en anglais) :

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'.

Citée depuis le SKILL.md au commit 07ade63 . Le dossier contient aussi 3 fichiers annexes (references/).

Le SKILL.md compte 37 lignes et 4 sections principales :

• Quick Reference
• When to Use This Skill
• Workflow
• Error Handling

Licence : MIT

Vérifiée le 10 novembre 2026 sur : fichier de licence d’un dossier parent (.github/plugins/aks-skills/LICENSE) . Licence déclarée dans le frontmatter : « MIT ». Titulaire : Copyright 2025 (c) Microsoft Corporation..

La licence autorise la reprise : le texte intégral du SKILL.md est reproduit ci-dessous, sans modification, avec sa mention de licence.

Texte intégral du SKILL.md

Reproduit sans modification depuis microsoft/skills (commit 07ade63) , © Microsoft, sous licence MIT (fichier de licence d’origine ).

---
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`](references/Invoke-PortalSearchNav.ps1) |
| Resource map | [`references/resource-types.json`](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

1. Collect **resource link** (portal URL or bare ARM resource ID) and **search query** from the user.
2. Run `references/Invoke-PortalSearchNav.ps1 -ResourceUrl '<link>' -Query '<query>'`.
3. The script signs in (browser by default; pass `-UseDeviceAuthentication` in headless/CLI
   environments), calls the search API, and prints portal deep links always rooted at
   `https://portal.azure.com`.

See [references/README.md](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` |