New-AzTag

How to create Azure tags using Azure PowerShell

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

Cmdlet Description:

CreatePredefinedTagSet: An Azure tag is a name-value pair that you can use to categorize your Azure resources and resource groups, such as by cost center or to track notes or department or comments associated with the resources and groups. Tags can be applied and defined in a single step, but predefined tags let you establish standard for the tags in your subscription. Use the Tag parameter of the New-AzTag cmdlet to apply a predefined tag to a resource or resource group. If you want to search for resource groups with a specified tag name or name and value, you can use the Tag parameter of the Get-AzResourceGroup cmdlet. Every tag has a name. The values are optional. A predefined Azure tag can have multiple values. When applying the tag to a resource or resource group, you should apply the tag name and only one of its values. For example, you can create a predefined Department tag with a value for each department, such as Finance, Human Resources, and IT. When you apply the Department tag to a resource, you apply only one predefined value, such as Finance.

When executed, this New-AzTag cmdlet allows you to create a predefined Azure tag with an optional predefined value. It can also be used to add additional values to existing predefined tags. Enter a unique tag name to create a predefined tag. To add a value to an existing predefined tag, you need to specify the name of the existing tag and the new value. When this command is executed, an object containing the new or modified tag with its values and the number of resources to which it has been applied is returned. New-AzTag is part of the Azure Tags Module and can help you manage predefined Azure tags.

CreateByResourceIdParameterSet: Additionally, the New-AzTag cmdlet along with a ResourceId creates or updates all the tags associated with a resource or subscription. This operation allows adding or replacing the entire set of tags on the specified resource or subscription. The specified entity can have a maximum of 50 tags.

PowerShell:

Example:

Create a predefined tag:

A predefined tag nambed "FY2020" is created without specified values.

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/.