Get-MailUser

  • Artículo

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2010-04-27

Utilice el cmdlet Get-MailUser para recuperar los atributos relacionados con el correo del usuario especificado en el servicio de directorio de Active Directory.

Sintaxis

get-MailUser [-Identity <MailUserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-MailUser [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-MailUser [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

Descripción detallada

El cdmlet Get-MailUser recupera todos los atributos relacionados con el correo del usuario especificado.

Para ejecutar el cmdlet Get-MailUser, se debe utilizar una cuenta en la que se delegue lo siguiente:

  • Función Administrador con permisos de vista de Exchange

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange Server 2007, consulte Consideraciones sobre permisos.

Nota

No todos los atributos de usuario se recuperan mediante el cmdlet Get-MailUser. Puede obtener atributos de usuario adicionales con el cmdlet Get-User.

Parámetros

Parámetro Necesario Tipo Descripción

ANR

Opcional

System.String

Este parámetro Anr especifica una cadena para realizar una búsqueda de resolución de nombres ambiguos. Puede especificar una cadena parcial y buscar objetos que tengan un atributo que coincida con esa cadena. Los atributos predeterminados buscados son:

  • CommonName (CN)

  • DisplayName (displayName)

  • FirstName (givenName)

  • LastName (sn)

  • Alias (mailNickname)

Credential

Opcional

System.Management.Automation.PSCredential

El parámetro Credential especifica la cuenta que se va a utilizar para obtener acceso a Active Directory.

Si se utiliza el parámetro Credential, el comando solicitará la contraseña de la cuenta antes de continuar.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración Active Directory, incluya el parámetro DomainController del comando.

Filter

Opcional

System.String

El parámetro Filter se utiliza para filtrar la lista de destinatarios devuelta. Puede especificar los atributos a filtrar.

Para obtener más información acerca de las propiedades filtrables, consulte Propiedades a las que se puede aplicar un filtro para el parámetro de filtrado.

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

El parámetro Identity identifica al usuario. Puede incluir el ADObjectID del usuario, nombre completo (DN), LegacyExchangeDN, GUID, Domain\SamAccountName, nombre principal de usuario (UPN), dirección de correo electrónico o alias.

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

El parámetro IgnoreDefaultScope indica al comando que omita la opción predeterminada del ámbito de destinatario para el Shell de administración de Exchange y que utilice todo el bosque como ámbito. Esto permite que el comando tenga acceso a objetos de Active Directory que no están actualmente en el ámbito predeterminado. El uso del parámetro IgnoreDefaultScope introduce las siguientes restricciones:

  • No puede utilizar el parámetro DomainController. El comando utilizará un servidor de catálogo global adecuado automáticamente.

  • Sólo puede utilizar el DN para el parámetro Identity. No se aceptan otras formas de identificación, como alias o GUID.

  • No puede utilizar los parámetros OrganizationalUnit e Identity juntos.

  • No puede utilizar el parámetro Credential.

OrganizationalUnit

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

El parámetro OrganizationalUnit especifica un contenedor en el que va a limitar los resultados. Puede especificar tanto una unidad organizativa (OU) como un dominio. El nombre canónico debería ser especificado. Por ejemplo:

  • OU: westcoast.contoso.com/users

  • Dominio: westcoast.contoso.com

ReadFromDomainController

Opcional

System.Management.Automation.SwitchParameter

El parámetro ReadFromDomainController especifica que la información del usuario se lee de un controlador de dominio del dominio del usuario. Si establece el ámbito de destinatarios para incluir todos los destinatarios en el bosque, y si no utiliza este parámetro, es posible que la información del usuario se lea de un catálogo global con información obsoleta. Si utiliza este parámetro, es posible que sea necesario realizar varias lecturas para obtener la información.

Nota

De forma predeterminada, el ámbito del destinatario se establece en el dominio que hospeda los servidores de Exchange.

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

El parámetro ResultSize especifica el número máximo de objetos del destinatario que se van a devolver. Si no se especifica, el parámetro devuelve todos los resultados que coinciden con el filtro.

SortBy

Opcional

System.String

El parámetro SortBy especifica el atributo según el que se ordenan los resultados. La clasificación se realiza por atributo de uno en uno y siempre en orden ascendente.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

Excepciones

Excepciones Descripción

 

Ejemplo

En el primer ejemplo, el comando Get-MailUser se utiliza sin parámetros para recuperar una lista completa de los usuarios habilitados para correo de la organización de Exchange al completo.

En el segundo ejemplo, las opciones de correo del usuario "Ted" se recuperan y se canalizan, a continuación, al cmdlet Format-List para que se muestren.

Get-MailUser
Get-MailUser -Identity Ted | Format-List