New command: m365 entra multitenant add

[MartinM85]

Usage

m365 entra multitenant add [options]

Description

Creates a new multitenant organization

Options

Option	Description
-n, --displayName <displayName>	Display name of the multitenant organization
-d, --description [description]	Description of the multitenant organization

Examples

Create a new multitenant organization

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

Default properties

No response

Additional Info

Multitenant organization is a brand new feature in Microsoft Entra ID

https://learn.microsoft.com/en-us/entra/identity/multi-tenant-organizations/overview

The signed-in user must be assigned at least the Security Administrator role. It requires new permission MultiTenantOrganization.ReadWrite.All

https://learn.microsoft.com/en-us/graph/api/tenantrelationship-put-multitenantorganization?view=graph-rest-1.0

I will work on it

[waldekmastykarz]

Thanks for the suggestion, @MartinM85. I suggest that we update the name to more clearly communicate what it's about. We could go along the lines of:

• m365 tenant relationship multitenant add
• m365 tenant multitenant add
• m365 entra multitenant add

@pnp/cli-for-microsoft-365-maintainers thoughts?

[MartinM85]

@waldekmastykarz You can also add a tenant to a multitenant organization, so maybe grouping under entra would be better.

m365 entra multitenant add - create a multitenant organization
m365 entra multitenant tenant add - add a tenant to a multitenant organization

[waldekmastykarz]

That's a good idea too. @pnp/cli-for-microsoft-365-maintainers thoughts?

[milanholemans]

Looks good to me.

[Adam-it]

the entra group seems ok to me as well 👍. Since the spec is aligned lets open it up 👍

[MartinM85]

@Adam-it I will work on it

[Adam-it]

All yours