Edit

Share via

New-EntraAdministrativeUnit

  • Reference
Module:
Microsoft.Graph.Entra

Creates an administrative unit.

Syntax

New-EntraAdministrativeUnit
   [-Description <String>]
   -DisplayName <String>
   [<CommonParameters>]

Description

The New-EntraAdministrativeUnit cmdlet creates an administrative unit in Microsoft Entra ID. Specify DisplayName parameter to create an administrative unit.

In delegated scenarios, the signed-in user must be assigned a supported Microsoft Entra role or a custom role that includes the microsoft.directory/administrativeUnits/allProperties/allTasks permission. The Privileged Role Administrator role is the least privileged role that meets this requirement.

Examples

Example 1: Create an administrative unit

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
New-EntraAdministrativeUnit -DisplayName 'TestAU'

DeletedDateTime Id                                   Description DisplayName Visibility
--------------- --                                   ----------- ----------- ----------
                bbbbbbbb-1111-2222-3333-cccccccccccc             TestAU

This example demonstrates how to create an administrative unit.

  • -DisplayName parameter specifies the display name for the Administrative unit object.

Example 2: Create an administrative unit using '-Description' parameter

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$params = @{
    DisplayName = 'Pacific Administrative Unit'
    Description = 'Administrative Unit for Pacific region'
}

New-EntraAdministrativeUnit @params

DeletedDateTime Id                                   Description DisplayName IsMemberManagementRestricted Visibility
--------------- --                                   ----------- ----------- ---------------------------- ----------
                bbbbbbbb-1111-2222-3333-cccccccccccc Pacific Administrative Unit     test111     False

This example demonstrates how to create an administrative unit.

  • -DisplayName parameter specifies the display name for the Administrative unit object.
  • -Description parameter specifies a description for the Administrative unit object.

Parameters

-Description

Specifies a description for the new administrative unit.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Specifies the display name of the new administrative unit.

Type:System.String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False