Sometimes it is necessary to create a new role to adjust it to our needs. Today, I want to show you how to create a custom role using Azure PowerShell with the JSON template.

This tutorial assumes that you already have a Microsoft Azure account configured.

Azure PowerShell Workaround

If you want to know how to install the PowerShell Azure module on your machine, check out this link.

The simplest way to get started is to sign in interactively at the command line.

This cmdlet will bring up a dialog box prompting you for your email address and password associated with your Azure account.
If you have more than one subscription associated with your mail account, you can choose the default subscription. To perform this task we will use the following commands:

Create a custom role

First I will create a JSON template as the source definition for the custom role. In my case, I will create a custom role that allows starting a virtual machine in my subscription. The Id should be set to null on the initial role created as a new ID is generated automatically.

To add the role to your subscription, you should use the New-AzRoleDefinition cmdlet with the following syntax:

custom role Azure

Verify the creation of a custom role

To List all Azure RBAC custom roles, use the Get-AzRoleDefinition cmdlet with the -Custom parameter.

Update a custom role

First, you must obtain the custom role definition and then modify the JSON file. To perform this task using the Get-AzRoleDefinition cmdlet with the following syntax:

Once the changes are made to the JSON file, you must use the Set-AzRoleDefinition cmdlet with the following syntax:


Delete a custom role

If you no longer need the role and want to delete it, use the Remove-AzRoleDefinition cmdlet with the following syntax:


If you want to know more about custom roles in Azure, check out this link: