Get-EntraDomainVerificationDnsRecord

Module:: Microsoft.Entra

Retrieve the ___domain verification DNS record for a ___domain.

Syntax

Get-EntraDomainVerificationDnsRecord
   -Name <String>
   [-Property <String[]>]
   [<CommonParameters>]

Description

Gets the ___domain's verification records from the verificationDnsRecords navigation property.

You can't use the ___domain with your Microsoft Entra ID tenant until you have successfully verified that you own the ___domain.

To verify the ownership of the ___domain, you need to first retrieve a set of ___domain verification records that you need to add to the zone file of the ___domain. This can be done through the ___domain registrar or DNS server configuration.

Root domains require verification. For example, contoso.com requires verification. If a root ___domain is verified, subdomains of the root ___domain are automatically verified. For example, subdomain.contoso.com is automatically be verified if contoso.com has been verified.

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
Global Reader

Examples

Example 1: Retrieve the ___domain verification DNS record

Connect-Entra -Scopes 'Domain.Read.All'
Get-EntraDomainVerificationDnsRecord -Name mail.contoso.com

Id                                   IsOptional Label                              RecordType SupportedService Ttl
--                                   ---------- -----                              ---------- ---------------- ---
aaaa0000-bb11-2222-33cc-444444dddddd False      mail.contoso.com Txt        Email            3600
bbbb1111-cc22-3333-44dd-555555eeeeee False      mail.contoso.com Mx         Email            3600

This example shows how to retrieve the Domain verification DNS records for a ___domain with the given name.

Parameters

-Name

The ___domain name for which the ___domain verification Domain Name System (DNS) records are to be retrieved.

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

-Property

Specifies properties to be returned.

Type:	System.String[]
Aliases:	Select
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

System.String

Outputs

System.Object

Share via