Compartir a través de


Get-AzADUser

Enumera las entidades de los usuarios o obtiene la entidad de los usuarios por clave.

Sintaxis

Get-AzADUser
   [-Count]
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-Filter <String>]
   [-Orderby <String[]>]
   [-Search <String>]
   [-ConsistencyLevel <String>]
   [-DefaultProfile <PSObject>]
   [-CountVariable <String>]
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -Mail <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -DisplayName <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -StartsWith <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -ObjectId <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -UserPrincipalName <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-SignedIn]
   [<CommonParameters>]

Description

Enumera las entidades de los usuarios o obtiene la entidad de los usuarios por clave.

Ejemplos

Ejemplo 1: Obtener usuario de inicio de sesión

Get-AzADUser -SignedIn

Obtención del usuario de inicio de sesión

Ejemplo 2: Enumerar usuarios

Get-AzADUser -First 10 -Select 'City' -AppendSelected

Enumere los primeros 10 usuarios y anexe la propiedad 'City' después de las propiedades predeterminadas: 'DisplayName', 'Id', 'DeletedDateTime', 'UserPrincipalName', 'UsageLocation', 'GivenName', 'AccountEnabled', 'MailNickName', 'Mail'

Ejemplo 3: Obtener usuario por nombre para mostrar

Get-AzADUser -DisplayName $name

Obtención del usuario por nombre para mostrar

Ejemplo 4: Obtención del usuario con filtro

Get-AzADUser -Filter "startsWith(DisplayName,'some-name')"

Obtención del usuario con filtro

Ejemplo 5: Asignación de OdataCount a una variable

Get-AzADUser -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result

Asignación de OdataCount a una variable

Parámetros

-AppendSelected

Anexar propiedades seleccionadas con propiedades predeterminadas cuando este modificador está activado, solo funciona con el parámetro "-Select".

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

-ConsistencyLevel

Indica el nivel de coherencia solicitado. Dirección URL de documentación: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

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

-Count

Incluir recuento de elementos

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

-CountVariable

Especifica un recuento del número total de elementos de una colección. De forma predeterminada, esta variable se establecerá en el ámbito global.

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

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:PSObject
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisplayName

nombre para mostrar del usuario

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

-Expand

Expansión de entidades relacionadas

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

-Filter

Filtre los elementos por valores de propiedad para obtener más detalles sobre la consulta de filtro, consulte: https://learn.microsoft.com/en-us/graph/filter-query-parameter

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

-First

Obtiene solo los primeros objetos 'n'.

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

-Mail

dirección de correo de usuario

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

-ObjectId

key: id. de usuario

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

-Orderby

Ordenar elementos por valores de propiedad

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

Buscar elementos por frases de búsqueda

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

-Select

Selección de propiedades que se van a devolver

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

-SignedIn

dirección de correo de usuario

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

-Skip

Omite los primeros objetos 'n' y, a continuación, obtiene los objetos restantes.

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

-StartsWith

el nombre para mostrar del usuario comienza por

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

-UserPrincipalName

nombre principal del usuario (user principal name)

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

Salidas

IMicrosoftGraphUser

Notas

ALIAS