Migrate-CopilotStudioAgents

What it is

A PowerShell toolkit that inventories agents, maps owner departments to existing environments, and copies classic Copilot Studio agents through Dataverse solutions.

Why use it

• Plan environment redistribution from a tenant-wide inventory before making changes.
• Preserve agent ownership and record-level sharing on a best-effort basis.
• Run a full dry-run migration plan with -WhatIf before importing solutions.

How to use it

1. Optionally generate and review department-environment-mapping.json.
2. Run Inventory-PowerPlatformAgents.ps1 to produce the raw inventory JSON.
3. Run Migrate-CopilotStudioAgents.ps1 with the inventory and mapping paths plus -WhatIf.
4. Review migration-plan.csv, rerun without -WhatIf, then reconfigure connections and validate each migrated agent.

Prerequisites

• Power Platform CLI and MSAL.PS
• Power Platform or reader admin role
• Microsoft Graph User.Read.All delegated access
• Dataverse access in source and target environments
• Pre-created target environments and target-user access