New-AzRoleDefinition

Active Directory Auditing Tool

The Who, Where and When information is very important for an administrator to have complete knowledge of all activities that occur on their Active Directory. This helps them identify any desired / undesired activity happening. ADAudit Plus assists an administrator with this information in the form of reports. In real-time, ensure critical resources in the network like the Domain Controllers are audited, monitored and reported with the entire information on AD objects - Users, Groups, GPO, Computer, OU, DNS, AD Schema and Configuration changes with 200+ detailed event specific GUI reports and email alerts.

Object Access » New-AzRoleDefinition

How to create a custom role using Azure PowerShell.

Written by Titus Manohar, IT security team, ManageEngine Updated on November 2025

Cmdlet Description:

The cmdlet allows you to create a custom role in the Azure Role Based Access Control (RBAC). To do this, you'll need to provide a PSRoleDefinition object or a JSON role definition file as the input. You can begin by using the Get-AzRoleDefinition command to generate a baseline role definition object. You can then modify the properties as required. This command can then be used to create custom roles using role definition parameter.

  • DisplayName: the name of the custom role
  • Description: Description of the role that shows the access that the role grants.
  • Actions: Operations to which the custom role grants access. Use Get-AzProviderOperation to get the operation for Azure resource providers that can be secured using Azure RBAC.
  • AssignableScopes: the scopes (Azure subscriptions or resource groups) in which the custom role is available for assignment. Using AssignableScopes you can limit the custom role to be available for assignment in only the subscriptions or resource groups that require it. This prevents cluttering the user experience for other subscriptions or resource groups.

PowerShell:

New-AzRoleDefinition [-InputFile] <String> [-DefaultProfile <IAzureContextContainer>] [<CommonParameters>]

Example:

New-AzRoleDefinition -InputFile C:\Temp\roleDefinition.json

Description: The above example display the cmdlet creating a custom role using a JSON string.

About ADAudit Plus

ADAudit Plus is a real time change auditing software that helps keep your Active Directory, Azure AD, Windows file servers, NetApp filers, EMC file systems, Synology file systems, Windows member servers, and workstations secure. With ADAudit Plus, you can get visibility into:

  • Authorized and unauthorized AD management changes
  • User logons, logoffs, and account lockouts
  • GPO changes
  • Group attribute and membership changes
  • OU changes
  • Privileged access and permission changes among other things.

There are more than 200 event-specific reports, and you can configure instant email alerts. You can also export the reports to XLS, HTML, PDF and CSV formats to assist in interpretation and forensics. For more information on ADAudit Plus, visit: https://www.manageengine.com/active-directory-audit/.

Explore Active Directory auditing and reporting with ADAudit Plus.

  •  
  •  
  •  
  • By clicking 'Schedule a personalized demo' you agree to processing of personal data according to the Privacy Policy.
Account Management Auditing
Active Directory Auditing
Windows Server Auditing