ensure-pipelines-host

Detects and provisions Power Platform Pipelines host environments before pipeline operations run.

808|167|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/microsoft/power-platform-skills --skill ensure-pipelines-host
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ensure-pipelines-host
Source: https://github.com/microsoft/power-platform-skills/tree/main/plugins/power-pages/skills/ensure-pipelines-host
Command: npx skills add https://github.com/microsoft/power-platform-skills --skill ensure-pipelines-host

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Power Platform Pipelines require a host environment with the Pipelines solution installed, but tenants often have no host configured, causing pipeline setup and deployment operations to fail. This Skill detects the tenant's host state and provisions a usable host before any pipeline operation runs.

Core Features & Use Cases

  • Host Detection: Mirrors the Power Apps UI resolution order (org-db setting, BAP environment metadata, tenant default-custom-host setting) to find existing Platform or Custom hosts.
  • Host Provisioning: Provisions a Platform Host via the idempotent BAP getOrCreate endpoint or a Custom Host via the BAP env-create API with the D365_ProjectHost template, with PPAC manual fallbacks.
  • Verification & Artifact: Polls lifecycle operations, verifies the host responds to Pipelines API calls, and writes a host-check artifact consumed by other ALM skills.
  • Use Case: Before running setup-pipeline for a Power Pages site, invoke this Skill to confirm the tenant has a working Pipelines host or create one with user-confirmed consent gates.

Quick Start

Ask the agent to ensure the tenant has a usable Power Platform Pipelines host environment before setting up a pipeline.

Frequently Asked Questions about ensure-pipelines-host

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a Power Platform Pipelines host environment?

Run this Skill to detect existing hosts using the same resolution order as the Power Apps UI, then provision a Platform Host via the idempotent BAP getOrCreate endpoint or a Custom Host via the env-create API with the D365_ProjectHost template. Manual PPAC paths are offered as fallbacks.

What is the difference between Platform Host and Custom Host in Power Platform Pipelines?

A Platform Host is a Microsoft-managed, tenant-singleton environment auto-provisioned via getOrCreate and hidden from the environment picker. A Custom Host is a regular Dataverse environment created by an admin with the D365_ProjectHost template or by installing the Pipelines app on an existing environment.

Does provisioning a Pipelines host require admin permissions?

Platform Host provisioning via getOrCreate does not require admin rights and is idempotent. Custom Host creation via the BAP env-create API requires Global, Power Platform, or Dynamics admin; non-admins receive a 403 and are guided to manual PPAC fallback paths.

Why does pipeline setup fail with no pipelines host error?

The source environment is not bound to any host and the tenant has no existing Platform or Custom Host. This Skill inventories the tenant, reuses an existing host if found, or provisions a new one after user confirmation.

Can this Skill rebind an environment to a different Pipelines host?

No. Rebinding requires Force Link, which is destructive because makers lose access to pipelines in the previous host. The Skill deliberately excludes Force Link, tenant default changes, environment deletion, and direct org-setting writes.