azureblog.co.uk
← cd ~/roles
// roles/azure · management-and-governance

Azure Connected Machine OnboardingAzure built-in role

Can onboard Azure Connected Machines.

Role IDb64e21ea-ac4e-4cdf-9dc9-5b892992bee7
CategoryManagement-and-governance
Actions11
Data actions0

What it can do

PermissionWhat it allows
Microsoft.HybridCompute/machines/readRead any Azure Arc machines
Microsoft.HybridCompute/machines/writeWrites an Azure Arc machines
Microsoft.HybridCompute/settings/readReads any Azure Arc settings
Microsoft.HybridCompute/settings/writeWrites an Azure Arc settings
Microsoft.HybridCompute/gateways/readReads any Azure Arc gateways
Microsoft.HybridCompute/privateLinkScopes/readRead any Azure Arc privateLinkScopes
Microsoft.GuestConfiguration/guestConfigurationAssignments/readGet guest configuration assignment.
Microsoft.Insights/dataCollectionRuleAssociations/writeCreate or update a resource's association with a data collection rule
Microsoft.Insights/dataCollectionRuleAssociations/deleteDelete a resource's association with a data collection rule
Microsoft.Insights/dataCollectionRuleAssociations/readRead a resource's association with a data collection rule
Microsoft.HybridCompute/machines/addExtensions/actionSetup Extensions on Azure Arc machines

Assign it

Scope it as tightly as you can: a resource or resource group rather than the whole subscription.

azure cli
az role assignment create \
  --assignee "jane.doe@contoso.com" \
  --role "Azure Connected Machine Onboarding" \
  --scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"
powershell3 lines
New-AzRoleAssignment -SignInName "jane.doe@contoso.com" `
  -RoleDefinitionName "Azure Connected Machine Onboarding" `
  -Scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"
bicep7 lines
resource assignment 'Microsoft.Authorization/roleAssignments@2022-04-01' = {
  name: guid(resourceGroup().id, principalId, 'b64e21ea-ac4e-4cdf-9dc9-5b892992bee7')
  properties: {
    roleDefinitionId: subscriptionResourceId('Microsoft.Authorization/roleDefinitions', 'b64e21ea-ac4e-4cdf-9dc9-5b892992bee7')
    principalId: principalId
  }
}

Who already has it?

kql · azure resource graph
authorizationresources
| where type == "microsoft.authorization/roleassignments"
| where tostring(properties.roleDefinitionId) endswith "b64e21ea-ac4e-4cdf-9dc9-5b892992bee7"
| project principalId = tostring(properties.principalId), principalType = tostring(properties.principalType), scope = tostring(properties.scope)

Other management-and-governance roles

Find the smallest role for a task →