New-AzTenantDeployment

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-AzTenantDeployment

How to create a deployment at a tenant scope using Azure PowerShell.

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

Description:

The New-AzTenantDeployment cmdlet adds a deployment at the current tenant scope.

The location and a template should be specified to add a deployment at tenant scope. Specifying the location informs Azure Resource Manager as to where to store the deployment data. The template comprises of a JSON string containing individual resources to be deployed. The template includes parameter placeholders for required resources and configurable property values, such as names and sizes.

To apply a custom template for the deployment, the TemplateFile parameter or TemplateUri parameter should be specified. Each template has parameters for configurable properties. The TemplateParameterFile parameter or the TemplateParameterObject parameter should be specified to add a template parameter. You can also add dynamic template parameters using command prompt. To do this, type the dynamic parameters at the command prompt. Alternatively you can type a minus sign (-) to indicate a parameter and use the Tab key to cycle through available parameters. Template parameter values that you enter at the command prompt take override values in a template parameter object or file.

To add resources to a subscription, use the New-AzSubscriptionDeployment cmdlet, which deploys subscription level resources. To add resources to a management group, use the New-AzManagementGroupDeployment, which creates a deployment at a management group.

PowerShell:

New-AzTenantDeployment [-Name <String>] -Location <String> [-DeploymentDebugLogLevel <String>] [-AsJob] -TemplateParameterFile <String> -TemplateFile <String> [-SkipTemplateParameterPrompt] [-ApiVersion <String>] [-Tag <Hashtable>] [-Pre] [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm] [<CommonParameters>]

Example:

New-AzTenantDeployment -Location "West US" -TemplateFile "D:\Azure\Templates\OrgSetup.json" -TemplateParameterFile "D:\Azure\Templates\OrgParms.json" -Tag @{"key1"="value1"; "key2"="value2";}

The above example shows the creation of a new deployment at the current tenant scope by using a custom template and a template file.

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 and compliant. 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
  • Azure AD logons, and changes to roles, groups, and applications
  • PowerShell scripts and modules

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