Get-EntraDirectoryObject
Pobiera obiekty katalogu na podstawie listy identyfikatorów.
Składnia
Default (domyślnie)
Get-EntraDirectoryObject
-DirectoryObjectIds <System.Collections.Generic.List`1[String]>
[-ObjectTypes <System.Collections.Generic.List`1[String]>]
[-Property <String[]>]
[<CommonParameters>]
Opis
Polecenie Get-EntraDirectoryObject cmdlet pobiera obiekty katalogu na podstawie listy identyfikatorów (lista maksymalnie 1000 identyfikatorów GUID (jako ciągów) do pobierania obiektów.
Przykłady
Przykład 1. Pobieranie obiektu co najmniej jednego identyfikatora obiektu
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
W tym przykładzie pokazano, jak pobierać obiekty dla określonych identyfikatorów obiektów.
-
DirectoryObjectIdsParametr określa listę maksymalnie 1000 identyfikatorów GUID (jako ciągów), dla których mają być pobierane obiekty.
Przykład 2. Pobieranie obiektu według typów
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
W tym przykładzie pokazano, jak pobierać obiekty dla określonego typu obiektu.
-
-DirectoryObjectIdsParametr określa listę maksymalnie 1000 identyfikatorów GUID (jako ciągów), dla których mają być pobierane obiekty. -
-ObjectTypesparametr określa typ identyfikatora obiektu.
Parametry
-DirectoryObjectIds
Jeden lub więcej identyfikatorów obiektów oddzielonych przecinkami, dla których są pobierane obiekty. Identyfikatory są identyfikatorami GUID reprezentowanymi jako ciągi. Można określić maksymalnie 1000 identyfikatorów.
Właściwości parametru
| Typ: | System.Collections.Generic.List`1[System.String] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Identyfikatory obiektów |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ObjectTypes
Określa typ obiektów zwracanych przez polecenie cmdlet. Jeśli nie zostanie określony, wartość domyślna to directoryObject, która zawiera wszystkie typy zasobów zdefiniowane w katalogu. W kolekcji można określić dowolny obiekt pochodzący z obiektu directoryObject, na przykład obiekty użytkownika, grupy i urządzenia.
Właściwości parametru
| Typ: | System.Collections.Generic.List`1[System.String] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Types |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Property
Określa właściwości, które mają być zwracane.
Właściwości parametru
| Typ: | System.String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Select |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.