用途:当用户想知道在 Azure 门户中何处对受支持的容器服务、已启用 Arc 的 Kubernetes 或计算资源执行某项操作,或需要指向特定边栏选项卡/菜单项的门户深层链接时使用。用户可提供门户 URL 或 ARM 资源 ID,以及自然语言搜索查询。
主要能力:脚本 references/Invoke-PortalSearchNav.ps1 接收 -ResourceUrl 与 -Query 参数,登录后调用搜索 API,输出始终以 https://portal.azure.com 为根的门户深层链接。资源类型映射见 references/resource-types.json,完整参数与 API 细节见 references/README.md。
使用方式:先安装 Az.Accounts 模块(Install-Module Az.Accounts -Scope CurrentUser),再运行 references/Invoke-PortalSearchNav.ps1 -ResourceUrl '<link>' -Query '<query>'。默认浏览器登录;无头或 CLI 环境加 -UseDeviceAuthentication 使用设备代码登录。
限制与错误处理:仅支持资源映射中已启用的提供程序类型,否则报“Resource type not enabled”;API 返回 401 通常为令牌无效或租户选择错误,需重新运行并选择可访问目标订阅租户的账户;结果为空表示查询无匹配导航项,可换搜索词;未安装 Az.Accounts 会报模块缺失;浏览器登录在无窗口句柄环境会失败,需改用设备代码认证。其余细节暂未提供。