Get-EntraDomainNameReference

Reference

Module:: Microsoft.Entra

Retrieves the objects that are referenced by a given domain name.

Syntax

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

Description

The Get-EntraDomainNameReference cmdlet retrieves the objects that are referenced with a given domain name. Specify Name parameter retrieve the objects.

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 name reference objects for a domain

Connect-Entra -Scopes 'Domain.Read.All'
Get-EntraDomainNameReference -Name contoso.com | Select-Object Id, DisplayName, '@odata.type'

Id                                   DisplayName              @odata.type               
--                                   -------------             ------------------------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Sawyer MIller            #microsoft.graph.user     
bbbbbbbb-1111-2222-3333-cccccccccccc Adele Vance              #microsoft.graph.user     
ffffffff-4444-5555-6666-gggggggggggg Contoso marketing        #microsoft.graph.group    
hhhhhhhh-5555-6666-7777-iiiiiiiiiiii Contoso App              #microsoft.graph.application

This example shows how to retrieve the domain name reference objects for a domain that is specified through the -Name parameter.

-Name parameter specifies the name of the domain name for which the referenced objects are retrieved.

Parameters

-Name

The name of the domain name for which the referenced objects are 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