Get-Contact
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-Contact para recuperar información acerca de un contacto o contactos especificados.
Sintaxis
Get-Contact [-Identity <ContactIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Contact [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Contact [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-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 permiso de 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:
|
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 de Active Directory que no están actualmente en el ámbito predeterminado. El uso del parámetro IgnoreDefaultScope introduce las siguientes restricciones:
|
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 especifica que la información del usuario tiene que leerse desde un controlador de dominio en el dominio del usuario. Si define el ámbito del destinatario para que incluya a todos los destinatarios del bosque, y si no utiliza este parámetro, es posible que la información del usuario se lea desde un catálogo global con información sin actualizar. Si utiliza este parámetro, pueden ser necesarias 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 que se devuelven. Los tipos de destinatarios de Microsoft Exchange Server 2007 se dividen en tipos y subtipos de destinatarios. Cada tipo de destinatario contiene todas las propiedades comunes para todos los subtipos. Por ejemplo, el tipo UserMailbox representa una cuenta de usuario de Active Directory con un buzón asociado. Debido a que existen distintos tipos de buzón, cada uno se identifica mediante 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. Para este comando, los detalles de tipo de destinatario disponibles son los siguientes:
|
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