Compartir a través de

  • Artículo

Get-CsExUmContact

 

Última modificación del tema: 2012-03-23

Recupera uno o varios objetos de contactos de Mensajería unificada de Exchange (UM) hospedados.

Sintaxis

Get-CsExUmContact [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

Descripción detallada

Microsoft Lync Server 2010 funciona en combinación con Mensajería unificada de Exchange para ofrecer varias capacidades de voz, como operador automático y acceso de suscriptor. Cuando Mensajería unificada de Exchange se ofrece como un servicio hospedado(no instalado en la organización), deben crearse objetos de contacto mediante Windows PowerShell para aplicar las funciones de operador automático y acceso de suscriptor. Este cmdlet recupera uno o varios de estos contactos.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet Get-CsExUmContact de forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsExUmContact"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

UserIdParameter

Identificador único del objeto de contacto que se quiere recuperar. Las identidades de contacto pueden especificarse con cuatro formatos: 1) La dirección SIP del contacto; 2) El nombre principal (UPN) del usuario del contacto; 3) el nombre de dominio y nombre de inicio de sesión del contacto con formato dominio\nombre (por ejemplo, litwareinc\exum1); y, 4) el nombre para mostrar de Active Directory del contacto (por ejemplo, Team Auto Attendant).

Tipo de datos completo: Microsoft.Rtc.Management.AD.UserIdParameter

Filter

Opcional

Cadena de caracteres

Permite limitar los datos que se devuelven filtrando los atributos específicos de Lync Server 2010. Por ejemplo, puede limitar los datos que se devuelven a los contactos que tengan identificadores URI de línea que comiencen por "tel:555".

El parámetro Filter usa el mismo subconjunto de sintaxis de filtrado de Windows PowerShell que usa el cmdlet Where-Object. Por ejemplo, un filtro que devuelva sólo contactos habilitados para Enterprise Voice tendría este aspecto: {EnterpriseVoiceEnabled -eq $True}, EnterpriseVoiceEnabled representa el atributo de Active Directory; -eq representa el operador de comparación (igual a); y $True (una variable de Windows PowerShell integrada) representa el valor del filtro.

LdapFilter

Opcional

Cadena de caracteres

Permite limitar los datos que se devuelven filtrando los atributos "genéricos" de Active Directory, es decir, los atributos que no son específicos de Lync Server.

El parámetro LdapFilter usa el lenguaje de consulta LDAP al crear filtros.

Credential

Opcional

PSCredential

Permite ejecutar el cmdlet con credenciales alternativas. Esto puede ser necesario si la cuenta usada para iniciar sesión en Windows no tiene los privilegios necesarios para trabajar con objetos de contacto.

Para usar el parámetro Credential, primero debe crear un objeto PSCredential llamando al cmdlet Get-Credential.

DomainController

Opcional

Fqdn

Permite conectarse al controlador de dominio especificado para recuperar información de contactos. Para conectarse a un controlador de dominio específico, debe incluir el parámetro DomainController seguido del nombre del equipo (por ejemplo, atl-mcs-001) o su nombre de dominio completo (por ejemplo, atl-mcs-001.litwareinc.com).

Tipo de datos completo: Microsoft.Rtc.Management.Deploy.Fqdn

OU

Opcional

OUIdParameter

Permite limitar la información recuperada a una unidad organizativa (OU) de Active Directory específica. Tenga en cuenta que con este parámetro se devuelven datos de la OU principal especificada y cualquier OU que contenga.

Al especificar una OU, use el nombre distintivo del contenedor; por ejemplo, OU=ExUmContacts,dc=litwareinc,dc=com.

ResultSize

Opcional

Integer

Le permite limitar el número de registros que devuelve un comando. Por ejemplo, para que se devuelvan solo siete contactos (al margen de la cantidad de contactos que haya en el bosque), simplemente incluya el parámetro ResultSize y defina el valor en 7. Tenga en cuenta que no es posible especificar qué 7 contactos se devolverán. Si se define el parámetro ResultSize en 7 pero solo hay tres contactos en el bosque, el comando devolverá esos tres contactos y se completará sin errores.

El tamaño del resultado puede definirse en cualquier número entero entre 0 y 2147483647, ambos incluidos. Si se establece en 0, el comando se ejecutará pero no devolverá datos.

Tipo de datos completo: Microsoft.Rtc.Management.ADConnect.Core.Unlimited

Tipos de entrada

Cadena de caracteres. Acepta un valor de cadena canalizado que representa la identidad de un objeto de contacto de Mensajería unificada de Exchange.

Tipos de valores devueltos

Devuelve un objeto de tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

Get-CsExUmContact

En este ejemplo, se recuperan todos los contactos de Mensajería unificada de Exchange definidos en una instalación de Lync Server 2010.

-------------------------- Ejemplo 2 --------------------------

Get-CsExUmContact -Identity sip:exum1@fabrikam.com

En este ejemplo, se recupera el contacto de Mensajería unificada de Exchange con la dirección SIP sip:exum1@fabrikam.com

-------------------------- Ejemplo 3 --------------------------

Get-CsExUmContact -Filter {Enabled -eq $False}

En este ejemplo, se usa el parámetro Filter para recuperar todos los contactos de Mensajería unificada de Exchange no habilitados para Lync Server 2010. Para ello, se filtra la propiedad Enabled para determinar si el valor es igual a (-eq) False ($False). Los contactos devueltos por este comando no funcionarán.

-------------------------- Ejemplo 4 --------------------------

Get-CsExUmContact -Filter {LineURI -like "tel:555*"}

Este comando filtra la propiedad LineURI para recuperar todos los contactos de Mensajería unificada de Exchange con un LineURI que empiece por 555. En otras palabras, recupera todos los contactos con un número de teléfono que empiece por 555.

-------------------------- Ejemplo 5 --------------------------

Get-CsExUmContact -OU "OU=ExUmContacts,DC=Vdomain,DC=com"

El comando de este ejemplo usa el parámetro OU para recuperar todos los contactos de Mensajería unificada de Exchange que se encuentran en la OU de Active Directory OU=ExUmContacts,DC=Vdomain,DC=com.