Get-EntraDirectoryObject

Hämtar katalogobjekt baserat på en lista med ID:er.

Syntax

Default (Standard)

Get-EntraDirectoryObject

    -DirectoryObjectIds <System.Collections.Generic.List`1[String]>
    [-ObjectTypes <System.Collections.Generic.List`1[String]>]
    [-Property <String[]>]
    [<CommonParameters>]

Description

Cmdleten Get-EntraDirectoryObject hämtar katalogobjekt baserat på en lista med ID:er (en lista med upp till 1 000 GUID:er (som strängar) att hämta objekt för).

Exempel

Exempel 1: Hämta ett objekt Ett eller flera objekt-ID:er

Connect-Entra -Scopes 'Directory.Read.All'
$groups = Get-EntraGroup -Limit 4
Get-EntraDirectoryObject -DirectoryObjectIds $groups.Id |
Select-Object Id, DisplayName, '@odata.type'
id                                   displayName    @odata.type
--                                   -----------    -----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Adele Vance    #microsoft.graph.user
bbbbbbbb-1111-2222-3333-cccccccccccc Contoso User   #microsoft.graph.user

Det här exemplet visar hur du hämtar objekt för ett angivet objekt-ID.

  • DirectoryObjectIds parameter anger en lista med upp till 1 000 GUID (som strängar) att hämta objekt för.

Exempel 2: Hämta ett objekt efter typer

Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraDirectoryObject -DirectoryObjectIds 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb', 'bbbbbbbb-1111-2222-3333-cccccccccccc' -ObjectTypes 'User' |
Select-Object Id, DisplayName, '@odata.type'
id                                   displayName    @odata.type
--                                   -----------    -----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Adele Vance    #microsoft.graph.user
bbbbbbbb-1111-2222-3333-cccccccccccc Contoso User   #microsoft.graph.user

Det här exemplet visar hur du hämtar objekt för en angiven objekttyp.

  • -DirectoryObjectIds parameter anger en lista med upp till 1 000 GUID (som strängar) att hämta objekt för.
  • -ObjectTypes parameter anger typen av objekt-ID.

Parametrar

-DirectoryObjectIds

Ett eller flera objekt-ID:er, avgränsade med kommatecken, för vilka objekten hämtas. ID:na är GUID:er, som representeras som strängar. Du kan ange upp till 1 000 ID:t.

Parameteregenskaper

Typ:

System.Collections.Generic.List`1[System.String]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ObjectIds

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ObjectTypes

Anger vilken typ av objekt som cmdleten returnerar. Om det inte anges är standardvärdet directoryObject, som innehåller alla resurstyper som definierats i katalogen. Du kan ange valfritt objekt som härleds från directoryObject i samlingen, till exempel användar-, grupp- och enhetsobjekt.

Parameteregenskaper

Typ:

System.Collections.Generic.List`1[System.String]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Types

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Property

Anger egenskaper som ska returneras.

Parameteregenskaper

Typ:

System.String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Select

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

None

Utdata

System.Object