Compartir a través de


Get-AzureADUser

Obtiene un usuario.

Sintaxis

Get-AzureADUser
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADUser
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
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 primeros usuarios

PS C:\>Get-AzureADUser -Top 10

Este comando obtiene 10 usuarios.

Ejemplo 2: Obtener un usuario por identificador

PS C:\>Get-AzureADUser -ObjectId "testUpn@tenant.com"

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    NewUser@contoso.onmicrosoft.com     Member
2b450b8e-1db6-42cb-a545-1b05eb8a358b New user    NewTestUser@contoso.onmicrosoft.com Member

Este cmdlet obtiene todos los usuarios que coinciden con el valor de SearchString con los primeros caracteres de DisplayName o UserPrincipalName.

Ejemplo 4: Obtener un usuario por userPrincipalName

PS C:\>Get-AzureADUser -Filter "userPrincipalName eq 'jondoe@contoso.com'"

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 por ventas, por ejemplo, el Administrador de ventas y el Asistente de ventas.

Parámetros

-All

Si es true, devuelva todos los usuarios. Si es false, devuelva el número de objetos especificados por el parámetro Top.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Filter

Especifica una instrucción de filtro de OData v3.0. Este parámetro controla qué objetos se devuelven. Puede encontrar detalles sobre la consulta con OData 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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ObjectId

Especifica el identificador (como UPN o ObjectId) de un usuario en Microsoft Entra ID.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SearchString

Especifica una cadena de búsqueda.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Top

Especifica el número máximo de registros que se van a devolver.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Notas

Consulte la guía de migración para Get-AzureADUser en Microsoft Graph PowerShell.