Skip to main content

entra multitenant add

Creates a new multitenant organization

Usage​

m365 entra multitenant add [options]

Options​

-n, --displayname <displayName>

Display name for the multitenant organization.

-d, --description [description]

Description for the multitenant organiztion.

-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 at least Security Administrator.

Permissions​

ResourcePermissions
Microsoft GraphMultiTenantOrganization.ReadWrite.All

Examples​

Create a new multitenant organization with display name only.

m365 entra multitenant add --displayName 'Contoso organization'

Create a new multitenant organization with display name and description.

m365 entra multitenant add --displayName 'Contoso organization' --description 'Multitenant organization between Contoso, Fabrikam, and Woodgrove Bank'

Response​

{
  "id": "c231d4a5-138f-4bdf-9fee-f26a90ea3ad0",
  "createdDateTime": "2024-05-05T05:05:05Z",
  "state": "active",
  "displayName": "Contoso organization",
  "description": "Multitenant organization between Contoso, Fabrikam, and Woodgrove Bank"
}

More information​