Get-UMMailbox (RTM)
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:
|
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:
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:
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