Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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. |