Get-MsolUser

Módulo:

MSOnline

Obtiene usuarios de Azure Active Directory.

Sintaxis

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 .

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

-City

Especifica la ciudad en la que se van a filtrar los resultados.

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

-Country

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

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

-Department

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

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

-EnabledFilter

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

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

-HasErrorsOnly

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

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

-LicenseReconciliationNeededOnly

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

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

-MaxResults

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

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

-ObjectId

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

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

-ReturnDeletedUsers

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

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

-State

Especifica el filtro para el estado del usuario.

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

-Synchronized

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

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

-Title

Especifica el filtro para el título del usuario.

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

-UnlicensedUsersOnly

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

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

-UserPrincipalName

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	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 necesario 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.

• GeneralProvisioningStatus. 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. Las 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.

Vínculos relacionados

• New-MsolUser
• Remove-MsolUser
• Restore-MsolUser
• Set-MsolUser