Get-MailUser (RTM)

 

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-06-05

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>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

Descripción detallada

Importante

En Microsoft Exchange Server 2007, las opciones del usuario habilitado para correo se recuperan sólo con el Shell de administración de Exchange.

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 de Exchange con permisos de sólo vista

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 usa el parámetro Credential, el comando le solicita 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 que se van 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 distintivo (DN), LegacyExchangeDN, GUID, Domain\SamAccountName, nombre principal de usuario (UPN), dirección de correo electrónico o alias.

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 indica que la información del usuario se lee desde un controlador de dominio en el dominio del usuario. Si ha establecido en el ámbito de destinatario que se incluyan todos los destinatarios del bosque y no usa este parámetro, es posible que la información del usuario se lea desde un catálogo global con información no actualizada. Si usa este parámetro, es posible que se necesiten 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 coincidan con el filtro.

SortBy

Opcional

System.String

El parámetro SortBy especifica el atributo según el que se ordenan los resultados. La ordenación se realiza atributo por atributo 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