Get-Contact (RTM)

Artículo
06/26/2014

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-06-05

Utilice el cmdlet Get-Contact para recuperar información acerca de un contacto o contactos especificados.

Sintaxis

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

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

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

Descripción detallada

El cmdlet Get-Contact consulta las propiedades de un contacto específico o de objetos de destinatario de contactos en el servicio de directorio de Active Directory.

Para ejecutar el cmdlet Get-Contact, se debe delegar a la cuenta 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.

Parámetros

Parámetro	Necesario	Tipo	Descripción
Anr	Opcional	System.String	El parámetro Anr se usa para buscar objetos que coincidan con una cadena parcial proporcionada. Es similar a una búsqueda usando caracteres comodines.
Credential	Opcional	System.Management.Automation.PSCredential	El parámetro Credential especifica la cuenta usada para consultar en Active Directory las credenciales del contacto.
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que recupera los datos de Active Directory, incluya el parámetro DomainController en el comando.
Filter	Opcional	System.String	El parámetro Filter especifica un conjunto de atributos que se usan para restringir los destinatarios que devuelve la consulta. 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.ContactIdParameter	El parámetro Identity toma uno de los siguientes valores: GUID Nombre distintivo (DN) Dominio\Cuenta Nombre principal de usuario (UPN) LegacyExchangeDN Dirección del Protocolo simple de transferencia de correo (SMTP) Alias
OrganizationalUnit	Opcional	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	El parámetro OrganizationalUnit devuelve objetos únicamente de la unidad organizativa especificada (OU).
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 ConferenceRoomMailbox, mientras que un buzón de usuario tendrá RecipientTypeDetails establecido en UserMailbox. Los detalles de los tipos de destinatarios disponibles para este comando son: Contact MailEnabledContact MailEnabledForestContact
ResultSize	Opcional	Microsoft.Exchange.Data.Unlimited	El parámetro ResultSize especifica el número máximo de resultados que se van a devolver.
SortBy	Opcional	System.String	El parámetro SortBy especifica la ordenación por un único atributo en orden ascendente.

Tipos de entrada

Tipos de valores devueltos

Errores

Error	Descripción

Excepciones

Excepciones	Descripción

Ejemplo

En este ejemplo, el comando Get-Contact obtiene el contacto Ted Bremer y canaliza el objeto hacia el comando Format-List para mostrar la información acerca del contacto.

Get-Contact -Identity TedBremer | Format-List

Compartir a través de