Get-MailContact

  • 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-MailContact para recuperar todos los atributos del contacto especificado desde Active Directory.

Sintaxis

Get-MailContact [-Identity <MailContactIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

Descripción detallada

Este cmdlet recupera todos los atributos del contacto especificado. No se necesitan parámetros. Si el cmdlet se ejecuta sin parámetros, se devuelve una lista completa de contactos de la organización de Exchange.

Para ejecutar el cmdlet Get-MailContact, debe usar una cuenta en la que se delegue lo siguiente:

  • Función Administrador de Exchange con permiso de vista

Para obtener más información sobre los permisos, funciones de delegación y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Obligatorio Tipo Descripción

ANR

Opcional

System.String

El parámetro especificado se resuelve mediante la resolución de nombres ambiguos (ANR). Los atributos predeterminados buscados son:

  • CommonName (CN)

  • DisplayName (displayName)

  • FirstName (givenName)

  • LastName (sn)

  • Alias (mailNickname)

  • LegacyExchangeDN (legacyExchangeDN)

  • Name (name) (en lugar de CommonName/CN)

  • EmailAddresses (proxyAddresses)

  • SamAccountName (samAccountName)

  • Office (physicalDeliveryOfficeName)

Credential

Opcional

System.Management.Automation.PSCredential

Este parámetro especifica la cuenta que se va a usar para obtener acceso a Active Directory.

Si se usa el parámetro Credential, el comando le solicita la contraseña de la cuenta antes de continuar.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar el nombre de dominio completo del controlador de dominio que recupera los datos de Active Directory, incluya el parámetro DomainController en el comando.

Filter

Opcional

System.String

Este parámetro se usa para filtrar la lista de destinatarios devuelta. Puede especificar los atributos que se van a filtrar.

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.MailContactIdParameter

Este parámetro identifica el contacto. Puede incluir el ADObjectID, el nombre distintivo, el LegacyExchangeDN, el GUID, el Domain\SamAccountName, el nombre principal de usuario (UPN), la dirección de correo electrónico o el alias del contacto.

OrganizationalUnit

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Este parámetro especifica un contenedor en el que limitar los resultados. Se puede especificar una unidad organizativa (OU) o un dominio. Del mismo modo, se debe especificar el nombre canónico. Por ejemplo:

  • OU: westcoast.contoso.com/users

  • Dominio: westcoast.contoso.com

ReadFromDomainController

Opcional

System.Management.Automation.SwitchParameter

Este parámetro 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 destinatarios de Exchange 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 ConferenceRoomMailbox, mientras que un buzón de usuario tendrá RecipientTypeDetails establecido en UserMailbox.

Los detalles de los tipos de destinatarios disponibles para este cmdlet son:

  • MailEnabledContact

  • MailEnabledForestContact

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

Este parámetro especifica el número total de objetos de destinatarios para devolver. Si no se especifica, el parámetro devuelve todos los resultados que coincidan con el filtro.

SortBy

Opcional

System.String

Este parámetro especifica el atributo según el que se ordenan los resultados. La ordenación se realiza atributo por atributo y siempre en orden ascendente.

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 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 usar el parámetro DomainController. El comando usará un servidor de catálogo global adecuado automáticamente.

  • Sólo puede usar 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 ni Identity juntos.

  • No puede usar el parámetro Credential.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

Excepciones

Excepciones Descripción

Ejemplo

En este ejemplo, el comando Get-MailContact se usa para recuperar el contacto con correo habilitado cuyo nombre es Ted.

Get-MailContact -Identity Ted | Format-List