New-MsolAdministrativeUnit

Adds a new administrative unit to Azure Active Directory.

Syntax

New-MsolAdministrativeUnit
   [-DisplayName <String>]
   [-Description <String>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

The New-MsolAdministrativeUnit cmdlet adds a new administrative unit to Azure Active Directory.

Examples

Example 1: Create an administrative unit

PS C:\> New-MsolAdministrativeUnit -DisplayName "West Coast" -Description "West Coast region"

This command creates a administrative unit called West Coast that has a description of West Coast region.

Parameters

-Description

Specifies a description for the administrative unit.

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

-DisplayName

Specifies a display name for the administrative unit.

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

-TenantId

Specifies the unique ID of the tenant on which to perform the operation. The default value is the tenant of the current user. This parameter applies only to partner users.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Outputs

Microsoft.Online.Administration.AdministrativeUnit

Will return the new administrative unit that was created.