Skip to article
Migration Migration planning

Azure Migrate

Azure Migrate helps organizations discover, assess, plan, and migrate servers, databases, web apps, virtual desktops, and other workloads to Azure with reduced risk.

Source: Microsoft Learn - About Azure Migrate Reviewed 2026-05-11

Exam trap
Running commands against the wrong subscription, tenant, workspace, cluster, or environment because context was not checked.
Production check
Can an operator show the current Azure Migrate configuration without using portal screenshots?
Article details and learning context
Aliases
Migrate, Azure Migrate hub, migration assessment
Difficulty
intermediate
CLI mappings
5
Last verified
2026-05-11
Learning paths Graph Migration concept cluster Azure Migrate

Understand the concept

In plain English

Azure Migrate is Azure’s migration hub for discovering workloads, assessing readiness and cost, and coordinating moves to Azure or Azure Local. In plain English, it gives teams a structured migration path that turns scattered inventory, sizing, dependency, cost, and readiness work into shared. You usually see it when teams need to plan datacenter exits, workload modernization, server moves, database migrations, web app migration, or Azure Local. It still needs ownership, monitoring, and change control. The practical question is whether it lets operators deploy, inspect, govern, or troubleshoot the workload clearly.

Why it matters

Azure Migrate matters because it turns a broad platform capability into something teams can design, review, and operate. Without a clear understanding of it, teams often make weak assumptions about ownership, limits, dependencies, or failure behavior. Used well, it helps architects choose the right boundary, gives operators observable signals, and gives security and finance teams evidence they can review. The value is not the label alone; the value is the repeatable operating model around it. For enterprise workload discovery, assessment, and migration execution, that operating model reduces surprises during releases, audits, incidents, and scale events. That clarity keeps small design choices from becoming hidden production risks.

Official wording and source

Azure Migrate helps organizations discover, assess, plan, and migrate servers, databases, web apps, virtual desktops, and other workloads to Azure with reduced risk. Microsoft Learn places it in About Azure Migrate; operators confirm scope, configuration, dependencies, and production impact. Use the linked source for exact Azure behavior.

Open Microsoft Learn

Technical context

Technically, Azure Migrate is configured through project, appliance, discovered servers, and assessment properties. Operators verify it with migrate CLI output, discovered server inventory, assessment reports, and readiness results. It integrates with Azure Migrate appliance, VMware, Hyper-V, and physical servers. Key settings include project region, appliance source, assessment type, and target Azure region. Capture desired state, compare it to live Azure state, and keep evidence for releases, incidents, and audits. These details matter because control-plane mistakes can affect many resources quickly.

Exam context

Compare with

Where it is used

Where you see it

  1. You see Azure Migrate in Azure Migrate project pages, discovered server inventory, assessment reports, appliance health, replication, where engineers confirm the design matches current resource state.
  2. You see Azure Migrate in migration runbooks where operators confirm discovery freshness, dependency owners, test migration results, where operators connect evidence to ownership, recent changes, and incident response.
  3. You see Azure Migrate in architecture reviews covering landing zone readiness, target sizing, dependency mapping, cost assumptions, where architects, security, operations, and finance teams keep one shared decision record.

Common situations

  • Use Azure Migrate for enterprise workload discovery, assessment, and migration execution when the workload needs repeatable governance.
  • Use it during production readiness reviews to confirm configuration, owners, and evidence.
  • Use it in incident response when operators need a shared technical reference.
  • Use it in automation when portal-only steps would create drift.

Illustrative Azure scenarios

These examples show how the concept can affect design and operations. They are illustrative scenarios, not customer claims.

Scenario 01 Datacenter exit assessment Scenario, objectives, solution, measured impact, and takeaway.
Scenario

HarborWind Logistics, a transportation organization, needed a fact-based migration plan for aging datacenter servers before lease renewal decisions.

Goals
  • Discover 680 servers across VMware clusters.
  • Create performance-based Azure sizing.
  • Group workloads into migration waves.
  • Estimate monthly run cost before approval.
Approach using Azure Migrate

The migration team deployed Azure Migrate appliances, collected server inventory and performance history, and created assessments for target Azure regions. Dependency analysis helped group warehouse, routing, and finance systems into waves. Cost assumptions included licensing benefits, storage tiers, and reserved capacity options. CLI inventory checks retrieved discovered servers for reconciliation with CMDB data. The final plan tied each wave to owners, test migration criteria, cutover windows, and post-migration validation tasks. The team also assigned named owners, saved acceptance evidence, and reviewed rollout notes with support staff responsible for datacenter exit assessment. A final readiness check compared design assumptions, operator permissions, monitoring signals, and rollback steps before the production milestone. After launch, the runbook kept Azure Migrate checks tied to the same business objective rather than letting the configuration drift silently.

Potential outcomes
  • Six hundred eighty servers were discovered and reconciled.
  • Performance-based sizing reduced overestimated VM cores by 28 percent.
  • Seven migration waves were approved by application owners.
  • Monthly run-cost estimates supported lease termination approval.
What to learn

Azure Migrate turns migration planning into evidence instead of guesswork when discovery and assessment are kept current.

Scenario 02 Healthcare app migration readiness Scenario, objectives, solution, measured impact, and takeaway.
Scenario

SilverCrest Clinics, a healthcare organization, had patient scheduling and billing systems with unknown dependencies across virtual machines and databases.

Goals
  • Map dependencies before migration approval.
  • Identify workloads not ready for Azure.
  • Run test migrations for critical systems.
  • Reduce cutover risk for clinic operations.
Approach using Azure Migrate

Cloud architects used Azure Migrate discovery, assessment reports, dependency information, and application owner workshops to classify workloads. Appliances collected performance and inventory data, while readiness results highlighted unsupported operating systems and undersized network assumptions. Test migrations validated scheduling and billing services in a landing zone. Operators used CLI checks to compare discovered server records with the project dashboard and to confirm migration job status during readiness reviews. The team also assigned named owners, saved acceptance evidence, and reviewed rollout notes with support staff responsible for healthcare app migration readiness. A final readiness check compared design assumptions, operator permissions, monitoring signals, and rollback steps before the production milestone. After launch, the runbook kept Azure Migrate checks tied to the same business objective rather than letting the configuration drift silently.

Potential outcomes
  • Critical dependencies were mapped before wave approval.
  • Eleven unsupported servers were remediated before migration.
  • Two test migrations met clinic acceptance criteria.
  • Cutover risks were reduced to owner-approved action items.
What to learn

Azure Migrate helps regulated migrations succeed by linking technical readiness to business-owner decisions.

Scenario 03 Azure Local migration planning Scenario, objectives, solution, measured impact, and takeaway.
Scenario

Cobalt County Services, a public sector organization, needed to move local government workloads from unsupported virtualization hosts to Azure Local without losing inventory control.

Goals
  • Discover legacy Hyper-V workloads.
  • Plan migration to Azure Local clusters.
  • Track replication and job status.
  • Validate public-service apps after cutover.
Approach using Azure Migrate

The county created an Azure Migrate project and used discovery data to identify aging Hyper-V workloads. Target architecture placed essential public-service applications on Azure Local clusters with Arc governance. Migration runbooks captured server owners, replication readiness, and test validation steps. CLI commands retrieved discovered server records and Azure Local migration job status for change meetings. Post-cutover checks compared service availability, VM performance, and backup coverage before source hosts were retired. The team also assigned named owners, saved acceptance evidence, and reviewed rollout notes with support staff responsible for azure local migration planning. A final readiness check compared design assumptions, operator permissions, monitoring signals, and rollback steps before the production milestone. After launch, the runbook kept Azure Migrate checks tied to the same business objective rather than letting the configuration drift silently.

Potential outcomes
  • Legacy Hyper-V workloads were documented by owner and service.
  • Azure Local targets were approved for essential applications.
  • Replication job status was visible during change windows.
  • Public-service apps passed post-cutover validation.
What to learn

Azure Migrate is useful for Azure Local programs when discovery, replication, and cutover evidence stay connected.

Azure CLI

Use Azure CLI for Azure Migrate when you need repeatable inventory, governed changes, deployment checks, migration evidence, or incident proof. CLI output makes scope, identity, configuration, and timing explicit, which is better than relying on screenshots or memory during reviews.

Useful for

  • Inventory Azure Migrate configuration across subscriptions, projects, tenants, or resource groups before a design review.
  • Capture repeatable evidence for incidents, audits, migrations, and release readiness checks.
  • Create or update supported settings through reviewed scripts instead of manual portal-only changes.
  • Compare expected state with actual state after deployment, rollback, migration, or platform upgrade work.

Before you run a command

  • Confirm the active tenant, subscription, resource group, workspace, cluster, or project before running any command.
  • Check whether the command is read-only, mutating, cost-impacting, security-impacting, or destructive.
  • Use least-privilege identity and store sensitive output in approved locations only.
  • Have rollback notes and owner contacts ready before changing production configuration.

What the output tells you

  • The output identifies the current Azure Migrate resource, setting, relationship, or runtime state being inspected.
  • IDs, regions, SKUs, tags, endpoints, identities, and scopes show whether deployment matches the design.
  • Empty or missing fields often reveal an incomplete configuration, wrong scope, unsupported feature, or stale deployment.
  • Metric and state values help separate Azure configuration issues from application behavior problems.

Mapped commands

Azure Migrate operations

preview-extension
az migrate get-discovered-server --project-name <project> --resource-group <resource-group>
az migratediscoverMigration
az migrate get-discovered-server --project-name <project> --resource-group <resource-group> --display-name <server-name>
az migratediscoverMigration
az migrate local replication list --project-name <project> --resource-group <resource-group>
az migrate local replicationdiscoverMigration
az migrate local replication get-job --project-name <project> --resource-group <resource-group> --job-name <job>
az migrate local replicationprotectMigration
az migrate local start-migration --project-name <project> --resource-group <resource-group> --machine-name <machine>
az migrate localoperateMigration

Architecture context

Technically, Azure Migrate is configured through project, appliance, discovered servers, and assessment properties. Operators verify it with migrate CLI output, discovered server inventory, assessment reports, and readiness results. It integrates with Azure Migrate appliance, VMware, Hyper-V, and physical servers. Key settings include project region, appliance source, assessment type, and target Azure region. Capture desired state, compare it to live Azure state, and keep evidence for releases, incidents, and audits. These details matter because control-plane mistakes can affect many resources quickly.

Security
Security for Azure Migrate starts with knowing who can configure it, who can use it, and what data or access path it can influence. The main risk is moving workloads from incomplete inventory, trusting stale performance samples, missing dependencies, weak cutover planning, or ignoring licensing and network constraints. Review RBAC assignments, managed identities, keys or credentials, network exposure, diagnostic logs, and any linked resources before production use. Prefer least privilege, private connectivity where appropriate, audited changes, and secret storage outside application code. Also confirm that support teams can prove the current configuration during an incident without relying on screenshots or memory. Document the approved evidence before the first high-risk change and review it during access recertification.
Cost
Cost impact for Azure Migrate comes from target VM sizing, reserved capacity assumptions, licensing benefits, storage tiers, network egress, temporary dual-running, migration tooling, and cleanup of source environments. The common waste pattern is enabling the capability for a pilot, then leaving resources, replicas, logs, or supporting infrastructure running after the original need changes. Estimate costs before rollout, tag resources to a clear owner, and compare steady-state usage with the design assumption. During reviews, look for unused resources, overbuilt tiers, avoidable data movement, and duplicated environments. Cost control works best when finance data is tied back to operational intent. Tie each optimization to an owner, forecast, and retirement date.
Reliability
Reliability depends on whether Azure Migrate is designed for the workload’s real failure modes. Focus on appliance health, discovery completeness, dependency accuracy, replication state, test migration results, rollback plans, cutover windows, and post-migration validation. A reliable design documents what should happen during scale-out, regional disruption, credential failure, deployment rollback, and operator error. Monitoring should show both the Azure resource state and the application symptoms users actually feel. Test the runbook before an outage, capture evidence from CLI or portal checks, and decide which failures require manual intervention versus automated recovery. Include dependency maps and health signals so responders know whether the platform or application failed during triage.
Performance
Performance depends on how Azure Migrate affects latency, throughput, deployment speed, or operator decision time. Focus on performance-based sizing, dependency latency, replication throughput, test migration timing, right-sized target SKUs, storage performance, and post-migration benchmark comparison. Do not assume the default setting is fast enough for production or that a faster tier fixes design problems. Measure before and after important changes, watch for throttling or slow control-plane calls, and test with realistic scale. Performance evidence should include user-facing symptoms, resource metrics, and configuration details so the team can distinguish service limits from application defects. Include baseline measurements so later tuning work has a defensible comparison point for teams.
Operations
Operationally, Azure Migrate should appear in runbooks, dashboards, release gates, and ownership records. Focus on wave planning, stakeholder approvals, appliance operations, assessment refreshes, dependency reviews, runbook ownership, migration job tracking, and readiness evidence for go-live. The team should know which commands are safe for inventory, which changes are mutating, and which outputs prove compliance or readiness. Keep naming, tags, environments, and documentation consistent so support engineers can find the right resource quickly. Review the configuration after major releases, incident retrospectives, platform upgrades, and cost reviews rather than treating it as a one-time setup. Assign a named owner, keep an escalation path, and review stale automation before quarterly platform reviews.

Common mistakes

  • Running commands against the wrong subscription, tenant, workspace, cluster, or environment because context was not checked.
  • Treating a successful create command as proof that security, monitoring, and operations are complete.
  • Copying examples into production without adjusting regions, names, identities, SKUs, and network rules.
  • Ignoring service-specific limits, preview behavior, retirement status, or required extensions before automation rollout.