Enterprise Live Migrations (ELM) CLI reference

Azure DevOps Services

This article lists the Azure DevOps CLI commands and parameters you use to run Enterprise Live Migrations (ELM), along with status and stage values the CLI returns during a migration.

Important

Use cutover now for the standard cutover flow. The cutover set command is intended only for exceptional cases where a specific future window is required; it isn't the recommended default approach.

Commands

Command Required parameters Optional parameters HTTP Description
list --org --include-inactive, --detect GET List migrations. By default, the CLI returns only active migrations.
status --org, --repository-id --detect GET Get detailed status for one migration.
create --org, --repository-id, --target-repository, --target-owner-user-id, --service-endpoint-id, --agent-pool --validate-only, --cutover-date, --skip-validation, --detect POST Create a new migration.
pause --org, --repository-id --detect PUT Pause an active migration.
resume --org, --repository-id --validate-only, --migration, --detect PUT Resume a stopped migration.
cutover now --org, --repository-id --detect PUT Start cutover immediately and return the review results. Use this as the standard path for cutover.
cutover set --org, --repository-id, --date --detect PUT Schedule a cutover date and time only when a specific future window is required.
cutover cancel --org, --repository-id --detect PUT Cancel a scheduled cutover.
cutover review --org, --repository-id List cutover failures awaiting approval.
cutover approve --org, --repository-id --accept-failures, --pipelines-verified, --detect PUT Approve cutover and skip the listed failures or acknowledge pipeline verification.
abandon --org, --repository-id --detect DELETE Permanently delete a migration. Prompts for confirmation.

Parameter details

Parameter Type Used by Description
--org URL All Azure DevOps organization URL, for example https://dev.azure.com/<org>. Set this value as a default.
--repository-id GUID All except list Azure Repos repository GUID. Get the value from az repos show --query id.
--target-repository URL create Target repository URL, for example https://<enterprise>.ghe.com/<org>/<repo>. The server validates this value.
--target-owner-user-id string create GitHub user ID (handle) of the target repository owner.
--service-endpoint-id GUID create Azure DevOps service connection ID that holds the GitHub PAT used to authenticate to the target.
--agent-pool string create Agent pool name for migration work.
--validate-only flag create, resume On create: run pre-migration checks only. On resume: switch to validate-only mode.
--migration flag resume Switch to full migration mode (clears validate-only). Mutually exclusive with --validate-only.
--cutover-date ISO 8601 create Pre-schedule cutover at creation time, for example 2030-12-31T11:59:00Z.
--date ISO 8601 cutover set Schedule cutover date and time only for a specific future window, for example 2030-12-31T11:59:00Z.
--skip-validation string create Comma-separated list of validation policies to skip.
--accept-failures integer cutover approve Number of unresolved items to accept when approving cutover.
--pipelines-verified flag cutover approve Confirm that pipeline rewiring has been reviewed and verified before cutover.
--include-inactive flag list Include completed, failed, and suspended migrations.
--detect flag All Auto-detect organization from the git remote (default: true). Use --detect false to disable.

Migration stages

Stage Description
Validation Running pre-migration checks.
Synchronization Copying and syncing repository content.
Cutover Running the final sync and transitioning to GitHub.
Migrated Migration complete. GitHub is the system of record.

Migration statuses

Status Meaning
Active Migration is running.
Succeeded / Completed Current phase completed successfully.
Failed Error occurred. You can resume the migration after fixing the issue.
Suspended Manually paused. You can resume the migration.