Get-EntraDirectoryObject
Recupera objetos de directorio basados en una lista de identificadores.
Sintaxis
Default (valor predeterminado)
Get-EntraDirectoryObject
-DirectoryObjectIds <System.Collections.Generic.List`1[String]>
[-ObjectTypes <System.Collections.Generic.List`1[String]>]
[-Property <String[]>]
[<CommonParameters>]
Description
El Get-EntraDirectoryObject cmdlet recupera objetos de directorio basados en una lista de identificadores (una lista de hasta 1000 GUID (como cadenas) para recuperar objetos).
Ejemplos
Ejemplo 1: Obtener un objeto Uno o varios identificadores 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
En este ejemplo se muestra cómo recuperar objetos para los identificadores de objeto especificados.
-
DirectoryObjectIdsel parámetro especifica una lista de hasta 1000 GUID (como cadenas) para recuperar objetos.
Ejemplo 2: Obtener un 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
En este ejemplo se muestra cómo recuperar objetos para un tipo de objeto especificado.
-
-DirectoryObjectIdsel parámetro especifica una lista de hasta 1000 GUID (como cadenas) para recuperar objetos. -
-ObjectTypesparameter especifica el tipo de identificador de objeto.
Parámetros
-DirectoryObjectIds
Uno o varios identificadores de objeto, separados por comas, para los que se recuperan los objetos. Los identificadores son GUID, representados como cadenas. Puede especificar hasta 1000 identificadores.
Propiedades de parámetro
| Tipo: | System.Collections.Generic.List`1[System.String] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | ObjectIds |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ObjectTypes
Especifica el tipo de objetos que devuelve el cmdlet. Si no se especifica, el valor predeterminado es directoryObject, que incluye todos los tipos de recursos definidos en el directorio. Puede especificar cualquier objeto derivado de directoryObject en la colección, como los objetos user, group y device.
Propiedades de parámetro
| Tipo: | System.Collections.Generic.List`1[System.String] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Tipos |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Property
Especifica las propiedades que se van a devolver.
Propiedades de parámetro
| Tipo: | System.String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Select |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.