Get-AzureADUser
Obtiene un usuario.
Sintaxis
GetQuery (Es el valor predeterminado).
Get-AzureADUser
[-All <Boolean>]
[-Top <Int32>]
[-Filter <String>]
[<CommonParameters>]
GetVague
Get-AzureADUser
[-SearchString <String>]
[-All <Boolean>]
[<CommonParameters>]
GetById
Get-AzureADUser
-ObjectId <String>
[-All <Boolean>]
[<CommonParameters>]
Description
El cmdlet Get-AzureADUser obtiene un usuario del identificador de Microsoft Entra.
Ejemplos
Ejemplo 1: Obtener los diez mejores usuarios
PS C:\>Get-AzureADUser -Top 10
Este comando obtiene 10 usuarios.
Ejemplo 2: Obtención de un usuario por identificador
PS C:\>Get-AzureADUser -ObjectId "[email protected]"
Este comando obtiene el usuario especificado.
Ejemplo 3: Búsqueda entre usuarios recuperados
PS C:\> Get-AzureADUser -SearchString "New"
ObjectId DisplayName UserPrincipalName UserType
-------- ----------- ----------------- --------
5e8b0f4d-2cd4-4e17-9467-b0f6a5c0c4d0 New user [email protected] Member
2b450b8e-1db6-42cb-a545-1b05eb8a358b New user [email protected] Member
Este cmdlet obtiene todos los usuarios que coinciden con el valor de SearchString con los primeros caracteres de DisplayName o UserPrincipalName.
Ejemplo 4: Obtención de un usuario por userPrincipalName
PS C:\>Get-AzureADUser -Filter "userPrincipalName eq '[email protected]'"
Este comando obtiene el usuario especificado.
Ejemplo 5: Obtener un usuario por JobTitle
PS C:\>Get-AzureADUser -Filter "startswith(JobTitle,'Sales')"
Este comando obtiene todos los usuarios cuyo título de trabajo comienza con ventas, por ejemplo, Gerente de ventas y Asistente de ventas.
Parámetros
-All
Si es true, devuelve todos los usuarios. Si es false, devuelve el número de objetos especificados por el parámetro Top
Propiedades del parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Filter
Especifica una instrucción de filtro OData v3.0. Este parámetro controla qué objetos se devuelven. Los detalles sobre las consultas con OData se pueden encontrar aquí. http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. No todas las funciones y operadores de OData v3.0 se admiten en este momento.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
GetQuery
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-ObjectId
Especifica el identificador (como UPN o ObjectId) de un usuario en el identificador de Microsoft Entra.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
GetById
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-SearchString
Especifica una cadena de búsqueda.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
GetVague
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Top
Especifica el número máximo de registros que se van a devolver.
Propiedades del parámetro
| Tipo: | Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
GetQuery
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| 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.
Notas
Consulte la guía de migración de Get-AzureADUser a Microsoft Graph PowerShell.