Edit

Share via

Confirm-EntraDomain

Module:
Microsoft.Entra.DirectoryManagement Module v1.1

Validate the ownership of a domain.

Syntax

Default (Default) 

Confirm-EntraDomain

    -Name <String>
    [-CrossCloudVerificationCode <CrossCloudVerificationCodeBody>]
    [<CommonParameters>]

Description

The Confirm-EntraDomain cmdlet validates the ownership of a 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-EntraDomain -Name Contoso.com

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

Example 2: Confirm the domain with a cross cloud verification code

Connect-Entra -Scopes 'Domain.ReadWrite.All'
Confirm-EntraDomain -Name Contoso.com -CrossCloudVerificationCode ms84324896

This example confirms a domain in dual federation scenarios.

Parameters

-CrossCloudVerificationCode

The cross-cloud domain verification code.

Parameter properties

Type:CrossCloudVerificationCodeBody
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

-Name

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

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.