mcpField
A
azure-search-nav

azure-search-nav

github.com/microsoft云与 DevOps1.6k95 次安装今天更新
代码仓库

关于 azure-search-nav

根据资源 URL 或 ARM 资源 ID 和搜索词生成 Azure Portal 导航链接的技能。它通过 PowerShell 和 Az.Accounts 身份验证，为受支持的资源类型查找匹配的门户页面。

主要功能

  1. 01接收门户 URL 或 ARM 资源 ID
  2. 02搜索 Azure Portal 导航项
  3. 03使用浏览器或设备代码进行身份验证
  4. 04返回门户深层链接
  5. 05支持已配置的资源类型

适用场景

  1. 01查找受支持 Azure 资源的门户页面
  2. 02定位执行操作所需的门户菜单
  3. 03根据 ARM 资源 ID 创建深层链接

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/microsoft/azure-skills --skill azure-search-nav

安装后在 Claude Code 中输入/azure-search-nav确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
Invoke-PortalSearchNav.ps1
README.md
resource-types.json

详细介绍

Azure 门户搜索链接生成器

快速参考

项目值
脚本references/Invoke-PortalSearchNav.ps1
资源映射references/resource-types.json
前置条件Az.Accounts PowerShell 模块
身份验证交互式 Microsoft 登录（Connect-AzAccount），或使用 -UseDeviceAuthentication 进行设备代码身份验证

何时使用此技能

  • 用户想了解如何在 Azure 门户中对受支持的 Container Service、Arc-enabled Kubernetes 或 Compute 资源执行某项操作。
  • 用户需要特定刀片或菜单项的门户深层链接。
  • 用户提供资源 URL 或 ARM 资源 ID，以及自然语言搜索查询。

工作流

  1. 收集用户提供的资源链接（门户 URL 或不带其他内容的 ARM 资源 ID）和搜索查询。
  2. 运行 references/Invoke-PortalSearchNav.ps1 -ResourceUrl '<link>' -Query '<query>'。
  3. 脚本会登录（默认使用浏览器；在无头／命令行环境中传入 -UseDeviceAuthentication），调用搜索 API，并输出始终以 https://portal.azure.com 为根地址的门户深层链接。

完整的参数参考和 API 详情请参阅 references/README.md。

错误处理

错误原因修复方法
未启用资源类型armProvider 不在 references/resource-types.json 中确认该类型在已启用的提供程序列表中
API 返回 401令牌无效，或选择了错误的租户重新运行，并选择有权访问目标订阅所在租户的账户
结果为空没有与查询匹配的导航项尝试其他搜索词
找不到 Az.Accounts未安装模块Install-Module Az.Accounts -Scope CurrentUser
浏览器登录失败（没有窗口句柄）无头／命令行环境使用 -UseDeviceAuthentication 重新运行

评论

支持 Markdown