Get-CASMailbox

  • Artículo

 

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

Última modificación del tema: 2011-01-21

El cmdlet Get-CASMailbox devuelve una lista de los atributos de un buzón de Microsoft Exchange Server 2007 en un equipo que tenga instalada la función de servidor de acceso de cliente.

Sintaxis

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

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

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

Parámetros

Parámetro Necesario Tipo Descripción

Anr

Opcional

System.String

Este parámetro acepta un conjunto de caracteres para realizar una búsqueda de resolución de nombres ambigua. Los atributos buscados incluyen lo siguiente:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

Opcional

System.Management.Automation.PSCredential

Este parámetro especifica la cuenta que se va a usar para leer desde el servicio de directorio Active Directory.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Este parámetro especifica el controlador de dominio para conectarse para la validación de Active Directory.

Filter

Opcional

System.String

Este parámetro especifica un conjunto de atributos que se usa para elaborar una consulta para recuperar un conjunto de buzones. Este parámetro no puede usarse en conjunto con el parámetro Database.

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 puede ser ADObjectID o una cadena que represente el GUID, nombre distintivo, dominio\cuenta, nombre principal de usuario, nombre distintivo de Exchange heredado, dirección SMTP o alias.

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 use 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 usar los parámetros OrganizationalUnit e Identity juntos.

No puede usar el parámetro Credential.

OrganizationalUnit

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Este parámetro se usa para limitar la búsqueda a un contenedor específico.

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 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 servidor de catálogo global cuya información no esté actualizada. Si usa este parámetro, es posible que se necesiten varias lecturas para recuperar la información.

Nota   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 especifica el número máximo de resultados a devolver. El valor predeterminado es 1000.

SortBy

Opcional

System.String

Este parámetro especifica el atributo usado para clasificar resultados. Los resultados se clasifican en orden ascendente.

Descripción detallada

El cmdlet Get-CASMailbox devuelve una lista completa de los atributos de un buzón de un servidor de acceso de cliente de Exchange 2007. Se devuelven diversos atributos CASMailbox. Entre los tipos de atributos devueltos se incluyen Outlook Web Access, ActiveSync, POP3 e IMAP4.

De forma predeterminada, todos los atributos son devueltos para todos los buzones en la organización de Exchange. Puede filtrar estos resultados mediante la funcionalidad en el comando de Shell de administración de Exchange.

El cmdlet Get-CASMailbox se puede ejecutar en un equipo de Exchange 2007 que tenga instalado el rol de servidor Buzón de correo. Para ejecutar el cmdlet Get-CASMailbox, la cuenta que use debe tener delegado el rol Administrador de Exchange con permiso 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 2007, consulte Consideraciones sobre permisos.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

 

Excepciones

Excepciones Descripción

 

 

Ejemplo

El código ejemplo devuelve todos los detalles del buzón del servidor de acceso de cliente para el usuario Jeff Hay en el dominio Contoso.

Get-CASMailbox -identity jeffhay@contoso.com