New-EntraBetaDomain
Creates a domain.
Syntax
New-EntraBetaDomain
-Name <String>
[-IsDefault <Boolean>]
[-SupportedServices <System.Collections.Generic.List`1[System.String]>]
[<CommonParameters>] Description
The New-EntraBetaDomain cmdlet creates a domain in Microsoft Entra ID.
In delegated scenarios, the signed-in user must have either a supported Microsoft Entra role or a custom role with the necessary permissions. The minimum roles required for this operation are:
- Domain Name Administrator
Examples
Example 1: Create a new Domain
Connect-Entra -Scopes 'Domain.ReadWrite.All'
New-EntraBetaDomain -Name test22.com
Id AuthenticationType AvailabilityStatus IsAdminManaged IsDefault IsInitial IsRoot IsVerified PasswordNotificationWindowInDays
-- ------------------ ------------------ -------------- --------- --------- ------ ---------- --------------------------------
test22.com Managed True False False False False 13This example demonstrates how to create a new domain in Microsoft Entra ID.
Example 2: Create a new Domain with a list of domain capabilities
Connect-Entra -Scopes 'Domain.ReadWrite.All'
New-EntraBetaDomain -Name test22.com -SupportedServices @('Email', 'OfficeCommunicationsOnline')
Id AuthenticationType AvailabilityStatus IsAdminManaged IsDefault IsInitial IsRoot IsVerified PasswordNotificationWindowInDays
-- ------------------ ------------------ -------------- --------- --------- ------ ---------- --------------------------------
test22.com Managed True False False False False 13This example demonstrates how to create a new domain with the specified services in Microsoft Entra ID.
Example 3: Create a new Domain and make if the default new user creation
Connect-Entra -Scopes 'Domain.ReadWrite.All'
New-EntraBetaDomain -Name test22.com -IsDefault $true
Id AuthenticationType AvailabilityStatus IsAdminManaged IsDefault IsInitial IsRoot IsVerified PasswordNotificationWindowInDays
-- ------------------ ------------------ -------------- --------- --------- ------ ---------- --------------------------------
test22.com Managed True False False False False 13This example demonstrates how to create a new domain in Microsoft Entra ID and marks it as the default to be used for new user creation.
Parameters
-IsDefault
Indicates whether or not this is the default domain that is used for user creation.
There is only one default domain per company.
| Type: | System.Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
The fully qualified name of the domain.
| Type: | System.String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SupportedServices
The capabilities assigned to the domain.
| Type: | System.Collections.Generic.List`1[System.String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |