Get-EntraDirectoryObject
Recupera objetos de diretório com base em uma lista de IDs.
Sintaxe
Default (Default)
Get-EntraDirectoryObject
-DirectoryObjectIds <System.Collections.Generic.List`1[String]>
[-ObjectTypes <System.Collections.Generic.List`1[String]>]
[-Property <String[]>]
[<CommonParameters>]
Description
O Get-EntraDirectoryObject cmdlet recupera objetos de diretório com base em uma lista de IDs (uma lista de até 1000 GUIDs (como cadeias de caracteres) para os quais recuperar objetos).
Exemplos
Exemplo 1: Obter um objeto Uma 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 ids de objeto especificadas.
-
DirectoryObjectIdso parâmetro especifica uma lista de até 1000 GUIDs (como cadeias de caracteres) para os quais 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.
-
-DirectoryObjectIdso parâmetro especifica uma lista de até 1000 GUIDs (como cadeias de caracteres) para os quais recuperar objetos. -
-ObjectTypeso parâmetro especifica o tipo de ID do objeto.
Parâmetros
-DirectoryObjectIds
Uma ou mais IDs de objeto, separadas por vírgulas, para as quais os objetos são recuperados. As IDs são GUIDs, representadas como cadeias de caracteres. Você pode especificar até 1.000 IDs.
Propriedades do parâmetro
| Tipo: | System.Collections.Generic.List`1[System.String] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Objectids |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ObjectTypes
Especifica o tipo de objetos que o cmdlet retorna. Se não for especificado, o padrão será directoryObject, que inclui todos os tipos de recursos definidos no diretório. Você pode especificar qualquer objeto derivado de directoryObject na coleção, como usuário, grupo e objetos de dispositivo.
Propriedades do parâmetro
| Tipo: | System.Collections.Generic.List`1[System.String] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Tipos |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Property
Especifica as propriedades a serem retornadas.
Propriedades do parâmetro
| Tipo: | System.String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Select |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.