Get-MsolUser

  • Referencia
Módulo:
MSOnline

Obtiene usuarios de Azure Active Directory.

Syntax

Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   -ObjectId <Guid>
   [-ReturnDeletedUsers]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   [-ReturnDeletedUsers]
   -UserPrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

El cmdlet Get-MsolUser obtiene un usuario individual o una lista de usuarios. Especifique el parámetro ObjectId o UserPrincipalName para obtener un usuario específico.

Ejemplos

Ejemplo 1: Obtener todos los usuarios

PS C:\> Get-MsolUser

Este comando recupera todos los usuarios de la empresa. Muestra hasta el valor predeterminado de 500 resultados.

Ejemplo 2: Obtener usuarios habilitados

PS C:\> Get-MsolUser -EnabledFilter EnabledOnly -MaxResults 2000

Este comando obtiene hasta 2000 usuarios habilitados.

Ejemplo 3: Obtener un usuario por UPN

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.com"

Este comando recupera al usuario con el UPN davidchew@contoso.com.

Ejemplo 4: Obtener un usuario por identificador de objeto

PS C:\> Get-MsolUser -ObjectId 81701046-cb37-439b-90ce-2afd9630af7d

Este comando recupera un usuario que tiene el identificador de objeto especificado.

Ejemplo 5: Obtener usuarios por cadena de búsqueda

PS C:\> Get-MsolUser -SearchString "David"

Este comando recupera una lista de usuarios con David en el nombre para mostrar o la dirección de correo electrónico.

Ejemplo 6: Obtener la ubicación de datos preferida de un usuario

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" | Select PreferredDataLocation

Este comando devuelve la ubicación de datos preferida de un usuario.

Parámetros

-All

Indica que este cmdlet devuelve todos los resultados. No especifique junto con el parámetro MaxResults .

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-City

Especifica la ciudad en la que filtrar los resultados.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Country

Especifica el país o región en el que filtrar los resultados.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Department

Especifica el departamento en el que se van a filtrar los resultados.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainName

Especifica el dominio en el que filtrar los resultados. Debe ser un dominio comprobado para la empresa. Se devuelven todos los usuarios con una dirección de correo electrónico, principal o secundaria, en este dominio.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnabledFilter

Especifica el filtro para usuarios habilitados o deshabilitados. Los valores válidos son All, EnabledOnly y DisabledOnly.

Type:UserEnabledFilter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HasErrorsOnly

Inidates que este cmdlet devuelve solo los usuarios que tienen errores de validación.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LicenseReconciliationNeededOnly

Indica que este filtro de cmdlet solo para los usuarios que requieren conciliación de licencias.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxResults

Especifica el número máximo de resultados que devuelve este cmdlet. El valor predeterminado es 500.

Type:Int32
Position:Named
Default value:500
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Especifica el identificador de objeto único del usuario que se va a obtener.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReturnDeletedUsers

Indica que este cmdlet devuelve solo los usuarios de la papelera de reciclaje.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SearchString

Especifica una cadena para que coincida con la dirección de correo electrónico o el nombre para mostrar a partir de esta cadena.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-State

Especifica el filtro para el estado del usuario.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Synchronized

Indica que este cmdlet devuelve solo los usuarios que se sincronizan a través de Azure Active Directory Sync.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

Especifica el identificador único del inquilino en el que se va a realizar la operación. El valor predeterminado es el inquilino del usuario actual. Este parámetro solo se aplica a los usuarios asociados.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Title

Especifica el filtro para el título del usuario.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UnlicensedUsersOnly

Indica que este cmdlet devuelve solo los usuarios que no tienen asignada una licencia.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UsageLocation

Especifica el filtro del país o región donde el usuario consume los servicios. Especifique un código de país o región de dos letras.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserPrincipalName

Especifica el identificador de usuario del usuario que se va a recuperar.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Salidas

Microsoft.Online.Administration.User

Este cmdlet devuelve objetos de usuario, que incluyen la siguiente información:

  • AlternateEmailAddresses. Dirección de correo electrónico alternativa del usuario (externa a Azure Active Directory).

  • BlockCredential. Devuelve si el usuario puede iniciar sesión o no.

  • Ciudad. La ciudad del usuario.

  • País. País o región del usuario.

  • Departamento. El departamento del usuario:

  • DisplayName. El nombre para mostrar del usuario.

  • Errores. Una matriz de errores. Estos son errores de validación que pueden provocar la pérdida de los servicios.

  • Fax. El número de fax del usuario.

  • Apellido. Nombre del usuario.

  • ImmutableID. Solo se devuelve para usuarios federados. Este es el identificador que se requiere para federarse con Azure Active Directory.

  • isBlackBerryUser. Devuelve si el usuario tiene un dispositivo BlackBerry o no.

  • isLicensed. Indica si el usuario tiene licencias asignadas o no.

  • LastDirSyncTime. Fecha y hora de la última sincronización de directorios (solo se devuelve de los usuarios sincronizados con Azure Active Directory a través de la sincronización de Active Directory).

  • LastPasswordChangeTimestamp. La hora más reciente en la que se registró un cambio de contraseña para el usuario en Azure Active Directory.

  • LastName. Apellidos del usuario.

  • LicenseReconciliationNeeded. Devuelve si el usuario tiene actualmente un buzón de correo sin licencia o no. En este caso, se debe otorgar una licencia de 30 días al usuario para evitar que pierda su buzón de correo.

  • Licencias. Una lista de licencias del usuario.

  • LiveID. El id. de inicio de sesión exclusivo del usuario.

  • Móvil. El número de teléfono móvil del usuario.

  • Idobjeto. El id. exclusivo del usuario.

  • Oficina. El número de la oficina del usuario.

  • OverallProvisioningStatus. Indica si se ha aprovisionado al usuario para sus servicios.

  • PasswordNeverExpires. Indica si la contraseña del usuario debe obligarse a cambiar cada 90 días.

  • PhoneNumber. El número de teléfono del usuario.

  • PostalCode. El código postal del usuario.

  • PreferredDataLocation. Ubicación de datos preferida del usuario.

  • PreferredLanguage. El idioma preferido del usuario.

  • Proxyaddresses. Direcciones de proxy asociadas a este usuario.

  • State El estado del usuario.

  • StreetAddress. La dirección del usuario.

  • StrongPasswordRequired. Indica si el usuario debe definir una contraseña segura cuando cambia la contraseña. Se recomiendan las contraseñas seguras.

  • Título. El título del usuario.

  • UsageLocation. País o región donde el usuario consume los servicios. Debe ser un código de país o región de dos letras.

  • Userprincipalname. El identificador de usuario del usuario.

  • ValidationStatus. Indica si el usuario tiene errores o no.