Get-EntraDirectoryObject
Recupera objetos de diretório com base numa lista de IDs.
Sintaxe
Default (Predefinição)
Get-EntraDirectoryObject
-DirectoryObjectIds <System.Collections.Generic.List`1[String]>
[-ObjectTypes <System.Collections.Generic.List`1[String]>]
[-Property <String[]>]
[<CommonParameters>]
Descrição
O Get-EntraDirectoryObject cmdlet recupera objetos de diretório com base numa lista de IDs (uma lista de até 1000 GUIDs (como strings) para recuperar objetos).
Exemplos
Exemplo 1: Obter um objeto Um ou mais IDs de objeto
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
Este exemplo demonstra como recuperar objetos para um ID de objeto especificado.
-
DirectoryObjectIdsparâmetro especifica uma lista de até 1000 GUIDs (como strings) para recuperar objetos.
Exemplo 2: Obter um objeto por tipos
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
Este exemplo demonstra como recuperar objetos para um tipo de objeto especificado.
-
-DirectoryObjectIdsparâmetro especifica uma lista de até 1000 GUIDs (como strings) para recuperar objetos. -
-ObjectTypeso parâmetro especifica o tipo de ID do objeto.
Parâmetros
-DirectoryObjectIds
Um ou mais IDs de objetos, separados por vírgulas, para os quais os objetos são recuperados. Os IDs são GUIDs, representados como strings. Pode especificar até 1.000 IDs.
Propriedades dos parâmetros
| Tipo: | System.Collections.Generic.List`1[System.String] |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | ObjectIds |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ObjectTypes
Especifica o tipo de objetos que o cmdlet devolve. Se não especificado, o predefinido é directoryObject, que inclui todos os tipos de recursos definidos no diretório. Pode especificar qualquer objeto derivado de directoryObject na coleção, como objetos utilizador, grupo e dispositivo.
Propriedades dos parâmetros
| Tipo: | System.Collections.Generic.List`1[System.String] |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Types |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Property
Especifica propriedades a devolver.
Propriedades dos parâmetros
| Tipo: | System.String[] |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Select |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.