Skip to content

Azure Migrate Collector Arc Extension: Clarify troubleshooting and required permissions #128740

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Jan-Hendrik Peters (nyanhp) wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Azure Migrate Collector Arc Extension: Clarify troubleshooting and required permissions #128740

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
01d8eac
Clarify troubleshooting and required permissions
nyanhp Aug 28, 2026
7f631ec
Update migrate-virtual-machine-extension-reference.md
nyanhp Sep 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion articles/migrate/migrate-virtual-machine-extension-reference.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -172,6 +172,10 @@ New-AzConnectedMachineExtension `

The extension uses the Arc-enabled server's managed identity to authenticate with Azure Migrate. No other permissions are required on the Azure Migrate project; the project automatically accepts data from Arc-enabled servers within its configured scope.

> [!NOTE]
> In order for the extension to send data to your Azure Migrate project, ensure that the project's system-assigned managed identity is assigned the **Migrate Arc Discovery Reader - Preview** role on the
> configured scopes containing your Arc-enabled servers.
Comment thread
v-dirichards marked this conversation as resolved.

## Extension status and health

### View extension status
Expand Down Expand Up @@ -219,6 +223,7 @@ az connectedmachine extension show \
| Extension installation fails | Insufficient permissions | Verify you have **Hybrid Server Resource Administrator** role |
| Extension shows Failed status | Network connectivity issue | Verify connectivity to regional endpoint |
| Extension installed but data not appearing in project | Project configuration incorrect | Verify project ID and region in extension settings |
| Extension installation successful, but status later changes to Failed | Incorrect project scope | Verify that the Azure Migrate scope contains your Arc-enabled servers |

## Update and removal

Expand Down Expand Up @@ -248,4 +253,4 @@ az connectedmachine extension delete \
- [Enable additional data collection for Arc-enabled servers](how-to-enable-additional-data-collection-for-arc-servers.md)
- [Create a migrate project for Arc resources](quickstart-evaluate-readiness-savings-for-arc-resources.md)
- [Manage sync of Arc resources to Azure Migrate project](how-to-manage-arc-resource-sync.md)
- [Create assessments](how-to-create-assessment.md)
- [Create assessments](how-to-create-assessment.md)