Get-EntraBetaDomainVerificationDnsRecord
Retrieve the domain verification DNS record for a domain.
Syntax
Default (Default)
Get-EntraBetaDomainVerificationDnsRecord
-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-EntraBetaDomainVerificationDnsRecord -Name mail.contoso.com
Id IsOptional Label RecordType SupportedService Ttl
-- ---------- ----- ---------- ---------------- ----
aaaabbbb-0000-cccc-1111-dddd2222eeee False contoso.com Txt Email 3600
aaaabbbb-1111-cccc-1111-dddd2222eeee False 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.
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 |
-Property
Specifies properties to be returned.
Parameter properties
| Type: | System.String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Select |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| 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.