Edit

Share via

Confirm-EntraBetaDomain

Module:
Microsoft.Entra.Beta.DirectoryManagement Module v1.1

Validate the ownership of a domain.

Syntax

Default (Default) 

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.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments:False

-ForceTakeover

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

Parameter properties

Type:System.Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.