Get-EntraDirectoryObject
Hiermee worden mapobjecten opgehaald op basis van een lijst met id's.
Syntax
Default (Standaard)
Get-EntraDirectoryObject
-DirectoryObjectIds <System.Collections.Generic.List`1[String]>
[-ObjectTypes <System.Collections.Generic.List`1[String]>]
[-Property <String[]>]
[<CommonParameters>]
Description
De Get-EntraDirectoryObject cmdlet haalt mapobjecten op op basis van een lijst met id's (een lijst met maximaal 1000 GUID's (als tekenreeksen) om objecten voor op te halen.
Voorbeelden
Voorbeeld 1: Een object ophalen een of meer object-id's
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 dit voorbeeld ziet u hoe u objecten ophaalt voor een opgegeven object-id.
-
DirectoryObjectIdsparameter specificeert een lijst met maximaal 1000 GUID's (als tekenreeksen) voor het ophalen van objecten.
Voorbeeld 2: Een object ophalen op type
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 dit voorbeeld ziet u hoe u objecten ophaalt voor een opgegeven objecttype.
-
-DirectoryObjectIdsparameter specificeert een lijst met maximaal 1000 GUID's (als tekenreeksen) voor het ophalen van objecten. -
-ObjectTypesparameter geeft het type object-id.
Parameters
-DirectoryObjectIds
Een of meer object-id's, gescheiden door komma's, waarvoor de objecten worden opgehaald. De id's zijn GUID's, weergegeven als tekenreeksen. U kunt maximaal 1000 id's opgeven.
Parametereigenschappen
| Type: | System.Collections.Generic.List`1[System.String] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | ObjectIds |
Parametersets
(All)
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-ObjectTypes
Hiermee geeft u het type objecten op dat door de cmdlet wordt geretourneerd. Als dit niet is opgegeven, is de standaardwaarde directoryObject, dat alle resourcetypen bevat die in de map zijn gedefinieerd. U kunt elk object opgeven dat is afgeleid van directoryObject in de verzameling, zoals gebruikers-, groeps- en apparaatobjecten.
Parametereigenschappen
| Type: | System.Collections.Generic.List`1[System.String] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Types |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Property
Hiermee geeft u eigenschappen die moeten worden geretourneerd.
Parametereigenschappen
| Type: | System.String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Selecteren |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.