Skip to content

Commit 60a12d8

Browse files
authored
Merge pull request #57771 from daveba/update-perms-howto-guides
[Azure AD MI]Update perms howto guides
2 parents 3a7fd54 + b10b41f commit 60a12d8

File tree

1 file changed

+8
-10
lines changed

1 file changed

+8
-10
lines changed

articles/active-directory/managed-identities-azure-resources/qs-configure-template-windows-vm.md

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -29,14 +29,6 @@ In this article, using the Azure Resource Manager deployment template, you learn
2929

3030
- If you're unfamiliar with using Azure Resource Manager deployment template, check out the [overview section](overview.md). **Be sure to review the [difference between a system-assigned and user-assigned managed identity](overview.md#how-does-it-work)**.
3131
- If you don't already have an Azure account, [sign up for a free account](https://azure.microsoft.com/free/) before continuing.
32-
- To perform the management operations in this article, your account needs the following Azure role based access control assignments:
33-
34-
> [!NOTE]
35-
> No additional Azure AD directory role assignments required.
36-
37-
- [Virtual Machine Contributor](/azure/role-based-access-control/built-in-roles#virtual-machine-contributor) to create a VM and enable and remove system and/or user-assigned managed identity from an Azure VM.
38-
- [Managed Identity Contributor](/azure/role-based-access-control/built-in-roles#managed-identity-contributor) role to create a user-assigned managed identity.
39-
- [Managed Identity Operator](/azure/role-based-access-control/built-in-roles#managed-identity-operator) role to assign and remove a user-assigned managed identity from and to a VM.
4032

4133
## Azure Resource Manager templates
4234

@@ -55,6 +47,8 @@ In this section, you will enable and disable a system-assigned managed identity
5547

5648
### Enable system-assigned managed identity during creation of an Azure VM or on an existing VM
5749

50+
To enable system-assigned managed identity on a VM, your account needs the [Virtual Machine Contributor](/azure/role-based-access-control/built-in-roles#virtual-machine-contributor) role assignment. No additional Azure AD directory role assignments are required.
51+
5852
1. Whether you sign in to Azure locally or via the Azure portal, use an account that is associated with the Azure subscription that contains the VM.
5953

6054
2. To enable system-assigned managed identity, load the template into an editor, locate the `Microsoft.Compute/virtualMachines` resource of interest within the `resources` section and add the `"identity"` property at the same level as the `"type": "Microsoft.Compute/virtualMachines"` property. Use the following syntax:
@@ -132,6 +126,8 @@ In this section, you will enable and disable a system-assigned managed identity
132126

133127
After you have enabled system-assigned managed identity on your VM, you may want to grant it a role such as **Reader** access to the resource group in which it was created.
134128

129+
To assign a role to your VM's system-assigned identity, your account needs the [User Access Administrator](/azure/role-based-access-control/built-in-roles#user-access-administrator) role assignment.
130+
135131
1. Whether you sign in to Azure locally or via the Azure portal, use an account that is associated with the Azure subscription that contains the VM.
136132

137133
2. Load the template into an [editor](#azure-resource-manager-templates) and add the following information to give your VM **Reader** access to the resource group in which it was created. Your template structure may vary depending on the editor and the deployment model you choose.
@@ -174,7 +170,7 @@ After you have enabled system-assigned managed identity on your VM, you may want
174170

175171
### Disable a system-assigned managed identity from an Azure VM
176172

177-
If you have a VM that no longer needs a system-assigned managed identity:
173+
To remove system-assigned managed identity from a VM, your account needs the [Virtual Machine Contributor](/azure/role-based-access-control/built-in-roles#virtual-machine-contributor) role assignment. No additional Azure AD directory role assignments are required.
178174

179175
1. Whether you sign in to Azure locally or via the Azure portal, use an account that is associated with the Azure subscription that contains the VM.
180176

@@ -210,6 +206,8 @@ In this section, you assign a user-assigned managed identity to an Azure VM usin
210206

211207
### Assign a user-assigned managed identity to an Azure VM
212208

209+
To assign a user-assigned identity to a VM, your account needs the [Virtual Machine Contributor](/azure/role-based-access-control/built-in-roles#virtual-machine-contributor) and [Managed Identity Operator](/azure/role-based-access-control/built-in-roles#managed-identity-operator) role assignments. No additional Azure AD directory role assignments are required.
210+
213211
1. Under the `resources` element, add the following entry to assign a user-assigned managed identity to your VM. Be sure to replace `<USERASSIGNEDIDENTITY>` with the name of the user-assigned managed identity you created.
214212

215213
**Microsoft.Compute/virtualMachines API version 2018-06-01**
@@ -352,7 +350,7 @@ In this section, you assign a user-assigned managed identity to an Azure VM usin
352350

353351
### Remove a user-assigned managed identity from an Azure VM
354352

355-
If you have a VM that no longer needs a user-assigned managed identity:
353+
To remove a user-assigned identity from a VM, your account needs the [Virtual Machine Contributor](/azure/role-based-access-control/built-in-roles#virtual-machine-contributor) role assignment. No additional Azure AD directory role assignments are required.
356354

357355
1. Whether you sign in to Azure locally or via the Azure portal, use an account that is associated with the Azure subscription that contains the VM.
358356

0 commit comments

Comments
 (0)