用途：将某个开发或目标环境的 Power Platform Pipelines 主机关联从一个主机迁移到另一个主机。这是部署环境创建（deploymentenvironments create）失败并报“此环境已关联到另一 Pipelines 主机”时的文档化修复手段，也用于有意在主机间迁移环境。
主要能力：在新主机上把现有 deploymentenvironments 记录标记为 BAP 环境的活动戳记并重跑校验，成功后 validationstatus 变为 Succeeded（200000001）；在旧主机上将对应行解除关联，旧主机中通过该环境运行管道的制作者将失去访问权限。该操作可通过从旧主机再次运行 Force Link 来撤销。
使用方式：按阶段执行。先检查前置条件（PAC CLI 已认证、Azure CLI 已登录、调用者需在目标主机具备 Deployment Pipeline Administrator 角色），并通过 Microsoft Learn 获取文档确认当前行为。随后确定目标主机 URL 和源环境的 BAP 环境 GUID，解析新主机上的 deploymentenvironments 记录（存在则复用，不存在则创建）。执行前必须经 AskUserQuestion 显式确认破坏性操作。之后运行脚本强制链接：node "${PLUGIN_ROOT}/scripts/lib/force-link-environment.js" --hostEnvUrl <hostEnvUrl> --token <hostToken> --deploymentEnvironmentId <guid>，脚本调用 ManageEnvironmentStamp（成功返回 204），并每 3 秒轮询 validationstatus 最多 20 次。最后写入标记文件 docs/alm/last-force-link.json 并输出摘要。
适用场景：部署环境创建因主机占用而失败时的修复；在主机间有意迁移环境。
限制：不会在目标主机安装 Pipelines 应用，也不会创建新主机环境本身；不会重新链接管道定义，仅移动环境与主机之间的戳记；不修改用户解决方案。每次调用只强制链接一个环境到一个主机，无 --yes 标志、无批处理模式、无同意结转。403 表示缺少目标主机的管理员角色，404 表示目标主机上不存在该记录。