Get-Mailbox (RTM)

  • Artículo

 

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-09-19

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

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

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

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

get-Mailbox [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-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 necesitan parámetros. Si el cmdlet se usa sin parámetros, se enumeran todos los buzones de la organización.

Para ejecutar el cmdlet Get-Mailbox, la cuenta que use debe tener delegado 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

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 usan 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 usan 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 usan 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 usar 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 se puede usar en conjunto con el parámetro Filter.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

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

Filter

Opcional

System.String

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

Este parámetro no se puede usar 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 usar uno de los siguientes valores:

  • GUID

  • Nombre distintivo (DN)

  • Dominio\Cuenta

  • Nombre principal de usuario (UPN)

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

OrganizationalUnit

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

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.

RecipientTypeDetails

Opcional

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

El parámetro RecipientTypeDetails especifica el tipo de destinatarios devueltos. 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 de todos los subtipos. Por ejemplo, el tipo UserMailbox representa una cuenta de usuario de Active Directory con un buzón asociado. Dado que existen varios tipos de buzones, cada uno 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.

Los detalles de los tipos de destinatarios disponibles para este comando 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, use "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 usa para limitar los resultados. Si usa este parámetro, solo obtendrá buzones que residen en el servidor que especifique. Use el nombre común del servidor que desee especificar.

SortBy

Opcional

System.String

El parámetro SortBy 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

  • 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