用途:在 Power Platform Pipelines 任何操作执行前,确保租户存在可用的 Pipelines 主机环境。主机是安装了 Power Platform Pipelines 托管解决方案的 Dataverse 环境,用于存放流水线、阶段、运行历史与工件。
主要能力:按与 Power Apps UI 一致(ProjectHostProvider.tsx)的解析顺序检测主机状态,识别平台主机(PE)、自定义主机(Custom Host)或无主机绑定等形态;支持复用已有主机;在 NoHost 状态下提供三条开通路径(新建平台主机、新建自定义主机、PPAC 手动开通);运行只读检测与列出环境等 BAP 调用;支持本地缓存快速路径(默认 24 小时,可用 --cacheMaxAgeHours 与 --no-cache 配置);读写侧采取 PAC 优先、BAP 回退策略。
使用方式:需要已登录 PAC CLI 与 Azure CLI,并提供源 Dataverse 环境 URL。技能会先校验租户身份并请求确认,再执行所选路径,最后做 JIT 预配校验并写入主机检查工件。
限制:不会静默创建任何环境,绑定或新建均需显式确认;不会调用 Force Link 重绑;不修改租户级 DefaultCustomPipelinesHostEnvForTenant;不删除环境;不直接写 ProjectHostEnvironmentId。每个环境同一时间只能绑定一个主机。检测到 CannotRedirect 会作为明确错误上报。BAP 环境 GET 返回 404 语义不明确,不作为“无主机”的唯一依据。PAC 无法显示平台主机,PE 检测需要可用的 BAP 令牌。部分管理员专属路径要求全局或 Power Platform 管理员权限。具体命令与参数以原始资料为准,未提供部分暂未说明。