Get-EntraDirectoryObject
Récupère des objets d’annuaire en fonction d’une liste d’ID.
Syntaxe
Default (Par défaut)
Get-EntraDirectoryObject
-DirectoryObjectIds <System.Collections.Generic.List`1[String]>
[-ObjectTypes <System.Collections.Generic.List`1[String]>]
[-Property <String[]>]
[<CommonParameters>]
Description
L’applet Get-EntraDirectoryObject de commande récupère des objets d’annuaire en fonction d’une liste d’ID (liste d’un maximum de 1 000 GUID (sous forme de chaînes) pour récupérer les objets pour 1000.
Exemples
Exemple 1 : Obtenir un objet Un ou plusieurs ID d’objet
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
Cet exemple montre comment récupérer des objets pour des ID d’objet spécifiés.
-
DirectoryObjectIdsle paramètre spécifie une liste de jusqu’à 1 000 GUID (sous forme de chaînes) pour récupérer des objets.
Exemple 2 : Obtenir un objet par types
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
Cet exemple montre comment récupérer des objets pour un type d’objet spécifié.
-
-DirectoryObjectIdsle paramètre spécifie une liste de jusqu’à 1 000 GUID (sous forme de chaînes) pour récupérer des objets. -
-ObjectTypesspécifie le type d’ID d’objet.
Paramètres
-DirectoryObjectIds
Un ou plusieurs ID d’objet, séparés par des virgules, pour lesquels les objets sont récupérés. Les ID sont des GUID, représentés sous forme de chaînes. Vous pouvez spécifier jusqu’à 1 000 ID.
Propriétés du paramètre
| Type: | System.Collections.Generic.List`1[System.String] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | ObjectIds |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ObjectTypes
Spécifie le type d’objets retournés par l’applet de commande. S’il n’est pas spécifié, la valeur par défaut est directoryObject, qui inclut tous les types de ressources définis dans le répertoire. Vous pouvez spécifier n’importe quel objet dérivé de directoryObject dans la collection, comme les objets utilisateur, groupe et appareil.
Propriétés du paramètre
| Type: | System.Collections.Generic.List`1[System.String] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Types |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Property
Spécifie les propriétés à retourner.
Propriétés du paramètre
| Type: | System.String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Sélectionnez |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.