Get-EntraDirectoryObject
Ruft Verzeichnisobjekte basierend auf einer Liste von IDs ab.
Syntax
Default (Standard)
Get-EntraDirectoryObject
-DirectoryObjectIds <System.Collections.Generic.List`1[String]>
[-ObjectTypes <System.Collections.Generic.List`1[String]>]
[-Property <String[]>]
[<CommonParameters>]
Beschreibung
Das Get-EntraDirectoryObject Cmdlet ruft Verzeichnisobjekte basierend auf einer Liste von IDs ab (eine Liste von bis zu 1000 GUIDs (als Zeichenfolgen), für die Objekte abgerufen werden sollen.
Beispiele
Beispiel 1: Abrufen eines Objekts ein oder mehrere Objekt-IDs
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
In diesem Beispiel wird veranschaulicht, wie Objekte für eine angegebene Objekt-ID abgerufen werden.
-
DirectoryObjectIdsder Parameter gibt eine Liste von bis zu 1000 GUIDs (als Zeichenfolgen) an, für die Objekte abgerufen werden sollen.
Beispiel 2: Abrufen eines Objekts nach Typen
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
In diesem Beispiel wird veranschaulicht, wie Objekte für einen angegebenen Objekttyp abgerufen werden.
-
-DirectoryObjectIdsder Parameter gibt eine Liste von bis zu 1000 GUIDs (als Zeichenfolgen) an, für die Objekte abgerufen werden sollen. -
-ObjectTypesder Parameter gibt den Typ der Objekt-ID an.
Parameter
-DirectoryObjectIds
Mindestens eine Objekt-IDs, getrennt durch Kommas, für die die Objekte abgerufen werden. Die IDs sind GUIDs, die als Zeichenfolgen dargestellt werden. Sie können bis zu 1.000 IDs angeben.
Parametereigenschaften
| Typ: | System.Collections.Generic.List`1[System.String] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | ObjectIds |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ObjectTypes
Gibt den Typ von Objekten an, die das Cmdlet zurückgibt. Wenn nicht angegeben, ist "directoryObject" der Standardwert, der alle im Verzeichnis definierten Ressourcentypen enthält. Sie können jedes objekt angeben, das von directoryObject in der Auflistung abgeleitet ist, z. B. Benutzer-, Gruppen- und Geräteobjekte.
Parametereigenschaften
| Typ: | System.Collections.Generic.List`1[System.String] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Typen |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Property
Gibt eigenschaften an, die zurückgegeben werden sollen.
Parametereigenschaften
| Typ: | System.String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Select |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.