Get-EntraDirectoryObject
Recupera gli oggetti directory in base a un elenco di ID.
Sintassi
Default (Impostazione predefinita)
Get-EntraDirectoryObject
-DirectoryObjectIds <System.Collections.Generic.List`1[String]>
[-ObjectTypes <System.Collections.Generic.List`1[String]>]
[-Property <String[]>]
[<CommonParameters>]
Descrizione
Il Get-EntraDirectoryObject cmdlet recupera gli oggetti directory in base a un elenco di ID (un elenco di un massimo di 1000 GUID (come stringhe) per recuperare gli oggetti.
Esempio
Esempio 1: Ottenere un oggetto Uno o più ID oggetto
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 questo esempio viene illustrato come recuperare oggetti per gli ID oggetto specificati.
-
DirectoryObjectIdsparametro specifica un elenco di un massimo di 1000 GUID (come stringhe) per cui recuperare gli oggetti.
Esempio 2: Ottenere un oggetto in base ai tipi
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 questo esempio viene illustrato come recuperare oggetti per un tipo di oggetto specificato.
-
-DirectoryObjectIdsparametro specifica un elenco di un massimo di 1000 GUID (come stringhe) per cui recuperare gli oggetti. -
-ObjectTypesparametro specifica il tipo di ID oggetto.
Parametri
-DirectoryObjectIds
Uno o più ID oggetto, separati da virgole, per cui vengono recuperati gli oggetti. Gli ID sono GUID, rappresentati come stringhe. È possibile specificare fino a 1.000 ID.
Proprietà dei parametri
| Tipo: | System.Collections.Generic.List`1[System.String] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | ObjectIds |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ObjectTypes
Specifica il tipo di oggetti restituiti dal cmdlet. Se non specificato, il valore predefinito è directoryObject, che include tutti i tipi di risorse definiti nella directory. È possibile specificare qualsiasi oggetto derivato da directoryObject nell'insieme, ad esempio oggetti utente, gruppo e dispositivo.
Proprietà dei parametri
| Tipo: | System.Collections.Generic.List`1[System.String] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Types |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Property
Specifica le proprietà da restituire.
Proprietà dei parametri
| Tipo: | System.String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Select |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.