force-link-environment
Plugin check: Run
node "${CLAUDE_PLUGIN_ROOT}/scripts/check-version.js"— if it outputs a message, show it to the user before proceeding.
force-link-environment
Move a dev or target environment's Power Platform Pipelines host association from one host to another. This is the documented remediation when deploymentenvironments create fails with "this environment is already associated with another pipelines host", and also the right tool when intentionally migrating environments between hosts.
Microsoft Learn (ground truth): Using Force Link to associate an environment with a new host
What this skill changes
In the target host (the new host the user wants to use):
- Marks the existing
deploymentenvironmentsrecord as the active stamp for the BAP environment. - Re-runs validation; on success,
validationstatusflips toSucceeded(200000001).
In the previous host (the host the env was previously linked to):
- The corresponding
deploymentenvironmentsrow is delinked. Itsvalidationstatusis left stale until refreshed in the previous host's UI. - Makers who could run pipelines through that environment in the previous host lose access to those pipelines via this environment.
The action is reversible by running Force Link again from the previous host.