Edit

Share via

Confirm-EntraBetaDomain

  • Reference
Module:
Microsoft.Entra.Beta

Validate the ownership of a domain.

Syntax

Confirm-EntraBetaDomain
       -DomainName <String>
       -ForceTakeover <Boolean>
       [<CommonParameters>]

Description

The Confirm-EntraBetaDomain cmdlet validates the ownership of an Microsoft Entra ID domain.

For delegated scenarios, the calling user must be assigned at least one of the following Microsoft Entra roles:

  • Domain Name Administrator

Examples

Example 1: Confirm the domain

Connect-Entra -Scopes 'Domain.ReadWrite.All'
Confirm-EntraBetaDomain -DomainName Contoso.com
  • DomainName Specifies the fully qualified domain name to retrieve.

This example verifies a domain and updates its status to verified.

Example 2: External admin takeover of a domain

Connect-Entra -Scopes 'Domain.ReadWrite.All'
Confirm-EntraBetaDomain -DomainName Contoso.com -ForceTakeover $True

This example illustrates how to confirm a domain when an external administrator needs to assume control of an unmanaged domain.

  • DomainName specifies the fully qualified domain name to retrieve.
  • ForceTakeover specifies whether to forcibly take control of an unmanaged domain associated with a tenant.

Parameters

-DomainName

Specifies the name of the domain.

Type:System.String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ForceTakeover

Used for external admin takeover of an unmanaged domain. The default value for this parameter is false.

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False