skills.rest
microsoft
microsoftOFFICIAL
Explore all skills by this author →
Website𝕏@OpenAtMicrosoftGitHub

import-solution

Imports Dataverse solution zips into target environments with staged dependency checks.

808|167|Updated Jan 21, 2026
Search Tags:#Deployment#power platform#Dataverse#ALM#Power Pages#PAC CLI#solution import
One-click install
npx skills add https://github.com/microsoft/power-platform-skills --skill import-solution
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: import-solution
Source: https://github.com/microsoft/power-platform-skills/tree/main/plugins/power-pages/skills/import-solution
Command: npx skills add https://github.com/microsoft/power-platform-skills --skill import-solution

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Deploying a Dataverse solution zip to a target Power Platform environment manually is error-prone: missing dependencies fail mid-import, same-version imports silently misbehave, environment variable values don't travel with the solution, and cloud flows need manual registration. This Skill orchestrates the entire import workflow with validation gates at each step.

Core Features & Use Cases

  • Staged Import with Dependency Checking: Runs StageSolution before committing to surface missing dependencies, then executes ImportSolutionAsync with async polling until completion.
  • Version-Skew Detection: Compares the zip's solution version against the installed version on the target and warns before same-version or downgrade imports.
  • Post-Import Configuration: Sets environment variable values, detects cloud flows requiring registration, and handles AttachmentBlocked errors by selectively unblocking file extensions.
  • Use Case: After exporting a Power Pages site solution from a dev environment, use this Skill to deploy it to staging or production with dependency validation, env var configuration, and an audit record written to docs/alm/last-import.json.

Quick Start

Ask the agent to import the exported solution zip into the target environment, optionally providing the path to the zip file.

Frequently Asked Questions about import-solution

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

FAQPage Schema
How do I import a Dataverse solution zip into another environment?▼

Authenticate PAC CLI to the target environment, then run this skill with the zip path. It stages the solution to check missing dependencies, executes ImportSolutionAsync, polls the async operation, and verifies the imported version.

What is the difference between staged and direct solution import?▼

Staged import runs StageSolution first to detect missing dependencies before committing, and is fully reversible. Direct import skips staging and imports immediately, which is faster but may fail mid-import if dependencies are absent.

Why does solution import fail with AttachmentBlocked error?▼

The target environment's blockedattachments security setting blocks file extensions present in the solution zip. The skill identifies the blocked extensions and, with your consent, removes only those types via pac env update-settings before retrying.

Do environment variable values transfer with solution import?▼

No. Environment variable definitions travel in the solution but their values do not. After import, the skill prompts you to enter target-specific values and POSTs environmentvariablevalue records for each definition.

What happens if I import the same solution version twice?▼

The skill detects same-version or downgrade imports by comparing the zip version against the installed version and warns you. It recommends re-exporting with a bumped version, since same-version imports have unreliable upgrade semantics.

Do cloud flows work automatically after solution import?▼

No. Cloud flows in the solution must be manually registered with the Power Pages site in the target environment via Power Pages Management. The skill detects flows in the zip and reminds you to register them.

Related Skills

Explore More Software Engineering Skills→
pnppnp
842

copilot-studio-agent-documenter

Generate Markdown documentation for Copilot Studio agents from Dataverse solutions.

Official
Intermediate
microsoftmicrosoft
10

mcs-deploy

Automate Microsoft Copilot Studio agent deployment between environments using PAC CLI.

Official
Advanced
gaiastudio-aigaiastudio-ai
2

gaia-release-plan

Plan staged software releases with rollback criteria and success metrics.

Official
Advanced
HouseGarofaloHouseGarofalo
3

power-platform

Manage Power Platform solution lifecycle via PAC CLI and CI/CD pipelines.

Official
Advanced