Get-UMMailbox (RTM)

  • Artículo

 

Se aplica a: Exchange Server 2007

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

El cmdlet Get-UMMailbox muestra las propiedades de mensajería unificada (UM) para un destinatario que se encuentra habilitado para la mensajería unificada.

Sintaxis

Get-UMMailbox [-Identity <MailboxIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

Descripción detallada

El cmdlet Get-UMMailbox recupera las propiedades de mensajería unificada para un único buzón. También puede devolver una lista con los buzones que tienen habilitada la mensajería unificada.

Para ejecutar el cmdlet Get-UMMailbox, la cuenta que utilice debe tener delegado lo siguiente:

  • Función Administrador de destinatarios 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.

Parámetros

Parámetro Necesario Tipo Descripción

Anr

Opcional

System.String

Este parámetro 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 que se buscan se indican a continuación:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

Opcional

System.Management.Automation.PSCredential

Este parámetro especifica el nombre de usuario y la contraseña que se utilizan para tener acceso al servicio de directorio Active Directory.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar el nombre de dominio completo del controlador de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory, incluya el parámetro DomainController en el cmdlet.

Filter

Opcional

System.String

Utilice este parámetro permite filtrar los resultados devueltos por el comando cmdlet.

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.MailboxIdParameter

Este parámetro especifica el usuario para habilitar la mensajería unificada. Entre las variables para este parámetro se incluyen las siguientes:

  • ADObjectID

  • GUID

  • DN

  • Dominio\Cuenta

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

Este parámetro es necesario si no se usa el parámetro Instance.

OrganizationalUnit

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Este parámetro especifica una unidad organizativa (OU) y se utiliza para limitar los resultados. Si utiliza este parámetro, solo recuperará buzones en el contendor que especifique. Puede utilizar la unidad organizativa o el nombre de dominio. Si utiliza la unidad organizativa, debe especificar el nombre canónico de la unidad organizativa.

ReadFromDomainController

Opcional

System.Management.Automation.SwitchParameter

Este parámetro indica que la información del usuario se leerá desde un controlador de dominio en el dominio del usuario. Si configurado el ámbito de destinatarios para incluir a todos los destinatarios del bosque y no utiliza este parámetro, es posible que la información de usuario se lea de un catálogo global cuya información sea obsoleta. Si utiliza este parámetro, es probable que se necesiten varias lecturas para obtener la información. De forma predeterminada, el ámbito del destinatario se establece en el dominio que aloja los servidores de Exchange.

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

Este parámetro le permite especificar un número máximo de resultados posible. Si no se especifica un número máximo, el cmdlet devuelve todos los resultados.

SortBy

Opcional

System.String

Este parámetro especifica el atributo según el que se ordenan los resultados. Sólo se puede seleccionar un atributo a la vez. Puede realizar la clasificación por los atributos siguientes:

  • Alias

  • DisplayName

  • Name

Los resultados se clasificarán en orden ascendente.

Tipos de entrada

Tipo Descripción

 

 

Tipos de valores devueltos

Tipo Descripción

 

 

Errores

Error Descripción

 

 

Ejemplo

El primer ejemplo de código muestra una lista de todos los buzones habilitados para mensajería unificada en el bosque de Active Directory en una lista con formato.

El segundo ejemplo de código muestra las propiedades de buzón de mensajería unificada para yanli@contoso.com.

Get-UMMailbox | format-list

Get-UMMailbox -Identity yanli@contoso.com