Get-UMMailbox

  • Artículo

 

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

Última modificación del tema: 2007-07-20

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

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

Get-UMMailbox [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-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 delegada la 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 Microsoft 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 en la que realizar una búsqueda de resolución de nombres ambiguos (ANR). 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

Este parámetro especifica el nombre de dominio completo del controlador de dominio que escribe este cambio de configuración de Active Directory.

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. Las variables de este parámetro son las siguientes:

  • ADObjectID

  • GUID

  • DN

  • Dominio\Cuenta

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

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

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

Este parámetro indica al comando que omita la opción predeterminada del ámbito de destinatario para el Shell de administración de Exchange y 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

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 especifica que la información del usuario se leerá desde un controlador de dominio en el dominio del usuario. Si ha establecido el alcance de los destinatarios para incluir todos los destinatarios del bosque y si no utiliza este parámetro, es posible que la información de usuario sea leída desde un catálogo global cuya información está obsoleta. Si utiliza este parámetro, serán necesarias varias lecturas para obtener la información. De forma predeterminada, el ámbito del destinatario se establece en el dominio que hospeda 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 de cada vez. Puede realizar la clasificación por los atributos siguientes:

  • Alias

  • DisplayName

  • Nombre

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