Get-Mailbox

  • 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-Mailbox para ver objetos y atributos de buzón, para rellenar páginas de propiedades o para suministrar información a otras tareas.

Sintaxis

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

get-Mailbox [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]

get-Mailbox [-Credential <PSCredential>] [-Database <DatabaseIdParameter>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

Descripción detallada

El cmdlet Get-Mailbox recupera los atributos y los objetos de un buzón. No se necesita ningún parámetro. Si el cmdlet se utiliza sin parámetros, se enumeran todos los buzones de la organización.

Para ejecutar el cmdlet Get-Mailbox, 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 Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.

Nota

Para evaluar de forma precisa el estado de la cuota de almacenamiento actual con el cmdlet Get-Mailbox es necesario consultar la propiedad UseDatabaseQuotaDefaults, así como las propiedades ProhibitSendQuota, ProhibitSendReceiveQuota e IssueWarningQuota. El valor True de la propiedad UseDatabaseQuotaDefaults significa que las configuraciones por buzón se ignoran y se utilizan los límites de base de datos de buzón. Si esta propiedad está configurada como True y las propiedades ProhibitSendQuota, ProhibitSendReceiveQuota e IssueWarningQuota están configuradas como ilimitadas, el buzón no tiene un tamaño ilimitado. Se deben consultar los límites de almacenamiento de base de datos de buzón para saber cuáles son los límites del buzón. El valor False de la propiedad UseDatabaseQuotaDefaults significa que se utilizan las configuraciones por buzón.

Parámetros

Parámetro Necesario Tipo Descripción

Anr

Opcional

System.String

El 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 con un atributo que coincida con esa cadena. Los atributos predeterminados que se buscan son:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

Opcional

System.Management.Automation.PSCredential

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

Database

Opcional

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

El parámetro Database especifica la base de datos desde la que se obtiene el buzón. Puede utilizar los siguientes valores:

  • GUID de la base de datos

  • Nombre de la base de datos

  • Nombre del servidor\nombre de la base de datos

  • Nombre del servidor\grupo de almacenamiento\nombre de la base de datos

Si no especifica el nombre del servidor, el cmdlet buscará la base de datos en el servidor local. Si tiene varias bases de datos con el mismo nombre en el mismo servidor, debe especificar el grupo de almacenamiento.

Este parámetro no puede utilizarse en conjunto con el parámetro Filter.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

El parámetro DomainController especifica el controlador de dominio que se utiliza para tener acceso a Active Directory. Utilice el nombre de dominio completo (FQDN) del controlador de dominio que desee utilizar.

Filter

Opcional

System.String

El parámetro Filter especifica uno o varios atributos que se utilizan para restringir los buzones que devuelve la consulta.

Este parámetro no puede utilizarse junto con el parámetro Database.

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

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

El parámetro Identity identifica el buzón. Puede utilizar los siguientes valores:

  • GUID

  • Nombre distintivo (DN)

  • Dominio\Cuenta

  • Nombre principal de usuario (UPN)

  • LegacyExchangeDN

  • SmtpAddress

  • 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 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 una unidad organizativa (OU) y se utiliza para limitar los resultados. Si utiliza este parámetro, solo obtendrá 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

El parámetro ReadFromDomainController especifica que la información del usuario se lee desde un controlador de dominio del dominio del usuario. Si se configura el ámbito del destinatario para incluir a todos los destinatarios del bosque y no se utiliza este parámetro, es posible que la información de usuario se lea desde un catálogo global con información obsoleta. Si utiliza este parámetro, pueden ser necesarias múltiples 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.

RecipientTypeDetails

Opcional

Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]

El parámetro RecipientTypeDetails especifica el tipo de destinatarios que se devuelven. Los tipos de destinatario de Microsoft Exchange Server 2007 se dividen en tipos y subtipos de destinatarios. Cada tipo de destinatario contiene todas las propiedades comunes a todos los subtipos. Por ejemplo, el tipo UserMailbox representa una cuenta de usuario de Active Directory con un buzón asociado. Puesto que existen varios tipos de buzón, cada uno de ellos se identifica con el parámetro RecipientTypeDetails. Por ejemplo, un buzón de una sala de conferencias tiene el parámetro RecipientTypeDetails establecido en RoomMailbox, mientras que un buzón de usuario tendrá RecipientTypeDetails establecido en UserMailbox.

Para este comando los detalles de tipo de destinatario disponibles son:

  • RoomMailbox

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • SharedMailbox

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

El parámetro ResultSize especifica el número máximo de resultados que se van a devolver. Si desea devolver todos los buzones que coinciden con la consulta, utilice "ilimitado" para el valor de este parámetro. El valor predeterminado es 1000.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

El parámetro Server especifica un servidor individual y se utiliza para limitar los resultados. Si utiliza este parámetro, solo obtendrá buzones que residen en el servidor que especifique. Utilice el nombre común del servidor que desee especificar.

SortBy

Opcional

System.String

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

  • Alias

  • Nombre para mostrar

  • Name

Los resultados se clasificarán en orden ascendente.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

Excepciones

Excepciones Descripción

 

Ejemplo

El primer ejemplo muestra la forma de obtener una lista de todos los buzones de la organización.

El segundo ejemplo muestra la forma de obtener una lista de todos los buzones de la organización en el contenedor Usuarios del dominio Contoso.com.

El tercer ejemplo muestra la forma de obtener todos los buzones de correo que se resuelven a partir de la búsqueda de resolución de nombres ambiguos en la cadena "Chr" que se encuentren en el dominio de DC01. Esto devolverá los buzones de correo de usuarios tales como Chris Ashton, Christian Cletus y Christa Geller.

Get-Mailbox -ResultSize unlimited
Get-Mailbox -OrganizationalUnit Users
Get-Mailbox -Anr Chr -DomainController DC01