Resolve-EntraTenant

Module:

Microsoft.Entra

Resolves a Tenant ID or Domain Name to a Microsoft Entra ID Tenant.

Syntax

Resolve-EntraTenant
       -TenantId <String[]>
       [<CommonParameters>]

Resolve-EntraTenant
       -DomainName <String[]>
       [<CommonParameters>]

Description

The Resolve-EntraTenant cmdlet resolves a Tenant ID or Domain Name to an Azure AD tenant and retrieves metadata about the tenant.

Examples

Example 1: Resolve a tenant by domain name

Connect-Entra -Scopes 'CrossTenantInformation.ReadBasic.All'
Resolve-EntraTenant -DomainName example.com

Environment                   : Global
ValueFormat                   : DomainName
Result                        : Resolved
ResultMessage                 : Tenant resolved successfully.
TenantId                      : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
DisplayName                   : Contoso, Ltd
DefaultDomainName             : CONTOSO18839.onmicrosoft.com
FederationBrandName           :
OidcMetadataResult            : Not Found
OidcMetadataTenantId          :
OidcMetadataTenantRegionScope :

Resolves the tenant with domain example.com.

Example 2: Resolve a tenant by GUID

Connect-Entra -Scopes 'CrossTenantInformation.ReadBasic.All'
$tenantId=(Get-EntraContext).TenantId
Resolve-EntraTenant -TenantId $tenantId

Environment                   : Global
ValueFormat                   : TenantId
Result                        : Resolved
ResultMessage                 : Tenant resolved successfully.
TenantId                      : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
DisplayName                   : Contoso, Ltd
DefaultDomainName             : CONTOSO18839.onmicrosoft.com
FederationBrandName           :
OidcMetadataResult            : Not Found
OidcMetadataTenantId          :
OidcMetadataTenantRegionScope :

Resolves the tenant with GUID aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb.

Example 3: Resolve tenants from a file

Connect-Entra -Scopes 'CrossTenantInformation.ReadBasic.All'
$domainList = Get-Content .\DomainList.txt
Resolve-EntraTenant -DomainName $domainList

Environment                   : Global
ValueToResolve                : Example1.com
ValueFormat                   : DomainName
Result                        : Resolved
ResultMessage                 : Resolved Tenant
TenantId                      : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
DisplayName                   : Example1, Ltd
DefaultDomainName             : example.com
FederationBrandName           :
OidcMetadataResult            : Resolved
OidcMetadataTenantId          : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
OidcMetadataTenantRegionScope : NA

Environment                   : Global
ValueToResolve                : Example2.com
ValueFormat                   : DomainName
Result                        : Resolved
ResultMessage                 : Resolved Tenant
TenantId                      : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
DisplayName                   : Example2, Ltd
DefaultDomainName             : Example.com
FederationBrandName           :
OidcMetadataResult            : Resolved
OidcMetadataTenantId          : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
OidcMetadataTenantRegionScope : NA

Resolves multiple tenants from a file containing a list of domain names.

Example 4: Resolve tenants Ids from a file

Connect-Entra -Scopes 'CrossTenantInformation.ReadBasic.All'
$tenantList = Get-Content .\TenantIdList.txt
Resolve-EntraBetaTenant -TenantId $tenantList

Environment                   : Global
ValueToResolve                : Example1.com
ValueFormat                   : TenantId
Result                        : Resolved
ResultMessage                 : Resolved Tenant
TenantId                      : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
DisplayName                   : Example1, Ltd
DefaultDomainName             : example.com
FederationBrandName           :
OidcMetadataResult            : Resolved
OidcMetadataTenantId          : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
OidcMetadataTenantRegionScope : NA

Environment                   : Global
ValueToResolve                : Example2.com
ValueFormat                   : TenantId
Result                        : Resolved
ResultMessage                 : Resolved Tenant
TenantId                      : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
DisplayName                   : Example2, Ltd
DefaultDomainName             : Example.com
FederationBrandName           :
OidcMetadataResult            : Resolved
OidcMetadataTenantId          : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
OidcMetadataTenantRegionScope : NA

Resolves multiple tenants from a file containing a list of TenantIds.

Parameters

-DomainName

Specifies one or more domain names to resolve.

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

-TenantId

Specifies one or more Tenant IDs to resolve.

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

Notes

• Uses Azure AD OIDC Metadata endpoint for resolution.
• A NotFound result doesn't necessarily mean the tenant doesn't exist; it might be in a different cloud environment.
• Requires CrossTenantInformation.ReadBasic.All scope to read Microsoft Graph API info.