Compartir a través de

Get-AzureRmADUser

  • Referencia
Módulo:
AzureRM.Resources

Filtra los usuarios de Active Directory.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Syntax

Get-AzureRmADUser
   [-UserPrincipalName <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADUser
   -StartsWith <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADUser
   -DisplayName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADUser
   -ObjectId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADUser
   -UserPrincipalName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADUser
   -Mail <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]

Description

Filtra los usuarios de Active Directory.

Ejemplos

Ejemplo 1: Enumerar todos los usuarios

PS C:\> Get-AzureRmADUser

Enumera todos los usuarios de AD de un inquilino.

Ejemplo 2: Enumeración de todos los usuarios mediante paginación

PS C:\> Get-AzureRmADUser -First 100

Enumera los primeros 100 usuarios de AD de un inquilino.

Ejemplo 3: Obtención del usuario de AD por nombre principal de usuario

PS C:\> Get-AzureRmADUser -UserPrincipalName foo@domain.com

Obtiene el usuario de AD con el nombre principal de usuario "foo@domain.com".

Ejemplo 4: Enumerar por cadena de búsqueda

PS C:\> Get-AzureRmADUser -SearchString Joe

Enumera todos los usuarios de AD cuyo nombre para mostrar comienza por "Joe".

Parámetros

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Nombre para mostrar del usuario.

Tipo:String
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:False
Accept wildcard characters:False

-First

Número máximo de objetos que se van a devolver.

Tipo:UInt64
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeTotalCount

Informa del número de objetos del conjunto de datos. Actualmente, este parámetro no hace nada.

Tipo:SwitchParameter
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-Mail

El correo del usuario.

Tipo:String
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

Id. de objeto del usuario.

Tipo:Guid
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-Skip

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

Tipo:UInt64
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-StartsWith

Se usa para buscar usuarios que comiencen con la cadena proporcionada.

Tipo:String
Aliases:SearchString
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-UserPrincipalName

UPN del usuario.

Tipo:String
Aliases:UPN
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

Guid

Salidas

PSADUser