Edit

Share via

Set-EntraDomain

  • Reference
Module:
Microsoft.Graph.Entra

Updates a domain.

Syntax

Set-EntraDomain
   -Name <String>
   [-IsDefault <Boolean>]
   [-SupportedServices <System.Collections.Generic.List`1[System.String]>]
   [<CommonParameters>]

Description

The Set-EntraDomain cmdlet updates a verified domain in Microsoft Entra ID.

The work or school account needs to belong to at least one of the following Microsoft Entra roles:

  • Domain Name Administrator
  • Security Administrator
  • External Identity Provider Administrator

Examples

Example 1: Set the domain as the default domain for new user account creation

Connect-Entra -Scopes 'Domain.ReadWrite.All'
Set-EntraDomain -Name Contoso.com -IsDefault $true

This example demonstrates how to set default domain for new user account in Microsoft Entra ID.

Example 2: Set the list of domain capabilities

Connect-Entra -Scopes 'Domain.ReadWrite.All'
Set-EntraDomain -Name Contoso.com -SupportedServices @('Email', 'OfficeCommunicationsOnline')

This example demonstrates how to set domain capabilities for new user account in Microsoft Entra ID.

Parameters

-IsDefault

Indicates whether or not this is the default domain that is used for user creation. There's 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:True
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