Skip to main content

entra administrativeunit add

Creates a new administrative unit

Usage​

m365 entra administrativeunit add [options]

Options​

-n, --displayname <displayName>

Display name for the administrative unit.

-d, --description [description]

Description for the administrative unit.

--hiddenMembership

Indicates whether the administrative unit and its members are hidden.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, permissions, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

info

To use this command you must be either Global Administrator or Privileged Role Administrator.

Permissions​

ResourcePermissions
Microsoft GraphAdministrativeUnit.ReadWrite.All

Examples​

Create an administrative unit with a specific display name

m365 entra administrativeunit add --displayName 'Marketing Division'

Create an administrative unit with a specific display name and description

m365 entra administrativeunit add --displayName 'Marketing Division' --description 'Marketing department administration'

Create a hidden administrative unit with a specific display name

m365 entra administrativeunit add --displayName 'Marketing Division' --hiddenMembership

Response​

{
  "id": "00b45a1b-7632-4e94-a3bd-f06aec976d31",
  "deletedDateTime": null,
  "displayName": "Marketing Division",
  "description": "Marketing department administration",
  "membershipRule": null,
  "membershipType": null,
  "membershipRuleProcessingState": null,
  "visibility": null
}

More information​