Compartir a través de

  • Artículo

Set-CsExUmContact

 

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

Modifica un objeto de contacto de acceso de suscriptor u operador automático existente de la Mensajería unificada de Exchange (UM) hospedada.

Sintaxis

Set-CsExUmContact -Identity <UserIdParameter> [-AutoAttendant <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

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. Estos objetos se crean llamando al cmdlet New-CsExUmContact y pueden modificarse posteriormente mediante el cmdlet Set-CsExUmContact.

La forma más fácil de usar este cmdlet es, en primer lugar, llamar a Get-CsExUmContact para recuperar una instancia del objeto de contacto que quiere modificar. Transferir el resultado del comando Get-CsExUmContact al cmdlet Set-CsExUmContact y asignar valores a los parámetros para las propiedades que quiera cambiar. (Para obtener más información, vea la sección de ejemplos de este tema.) También puede llamar al cmdlet Set-CsExUmContact, enviándole el valor de Identity del objeto de contacto que quiera modificar.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsExUmContact de forma local: RTCUniversalUserAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

UserIdParameter

Identificador único del objeto de contacto que se quiere modificar. 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

AutoAttendant

Opcional

Booleano

Defina el parámetro en True, si el objeto de contacto es un operador automático. Este parámetro es False de forma predeterminada.

Description

Opcional

Cadena de caracteres

Descripción de este contacto. La descripción permite a los administradores identificar el tipo de contacto (operador automático o acceso de suscriptor), la ubicación, el proveedor o cualquier otra información que identifique el propósito de cada contacto de Mensajería unificada de Exchange.

DisplayNumber

Opcional

Cadena de caracteres

El número de teléfono del contacto. Los números para mostrar de cada contacto deben ser únicos (no puede haber dos contactos de Mensajería unificada de Exchange con el mismo número para mostrar). Si se cambia este valor, se cambiará también el valor de la propiedad LineURI.

Este valor puede empezar con un signo más (+) y puede contener cualquier cantidad de dígitos. El primer dígito no puede ser cero.

Enabled

Opcional

Booleano

Indica si el contacto se ha habilitado para Lync Server 2010. Si define este parámetro en False, se deshabilitará el contacto y el operador automático o el acceso de suscriptor asociado con el contacto no funcionará.

Si se deshabilita una cuenta usando el parámetro Enabled, se conserva la información asociada con la cuenta (incluidas las directivas de correo de voz hospedado asignadas). Si se reactiva la cuenta más adelante con el parámetro Enabled, la información asociada con la cuenta se restaurará.

EnterpriseVoiceEnabled

Opcional

Booleano

Indica si el contacto se ha habilitado para Enterprise Voice. Si define este valor en False, no estará disponible la característica de operador automático o acceso de suscriptor asociada con el contacto.

SipAddress

Opcional

Cadena de caracteres

La dirección SIP del contacto. Debe ser una dirección nueva que no exista ya como usuario o contacto en Active Directory Domain Services (AD DS).

Si se cambia este valor, también cambiará la dirección SIP almacenada en la propiedad OtherIpPhone.

El parámetro SipAddress se puede usar como valor de Identity con los comandos Get-CsExUmContact para recuperar contactos específicos. Al llamar al cmdlet, se usará el nuevo parámetro SipAddress; las consultas de la dirección SIP antigua no devolverán ningún objeto.

DomainController

Opcional

Fqdn

Permite especificar un controlador de dominio. Si no se especifica ninguno, se usará el primero que haya disponible.

PassThru

Opcional

Parámetro modificador

Devuelve los resultados del comando. De forma predeterminada, este cmdlet no genera resultados.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact. Acepta la entrada transferida de objetos de contacto de Mensajería unificada de Exchange.

Tipos de valores devueltos

Este cmdlet modifica un objeto de tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact. Cuando se utiliza el parámetro PassThru, también devuelve un objeto de este tipo.

Ejemplo

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

Get-CsExUmContact -Identity sip:exumsa4@fabrikam.com | Set-CsExUmContact -AutoAttendant $True

En este ejemplo se define la propiedad AutoAttendant del contacto Mensajería unificada de Exchange con la dirección SIP exumsa4@fabrikam.com en True. Primero se llama al objeto Get-CsExUmContact para recuperar el objeto de contacto. (También se podría haber usado el nombre para mostrar de Active Directory del contacto, el nombre principal del usuario del contacto o el nombre de inicio de sesión del contacto.) Este comando recupera el contacto con el valor de Identity proporcionado. A continuación, el contacto se envía al cmdlet Set-CsExUmContact, donde se define el parámetro AutoAttendant en True.

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

Set-CsExUmContact -Identity "CN={1bf6208d-2847-45d0-828f-636f14da858b},OU=ExUmContacts,DC=litwareinc,DC=com" -AutoAttendant $True

Este ejemplo es idéntico al Ejemplo 1, pero en lugar de recuperar el contacto llamando a Get-CsExUmContact y transfiriendo el objeto a Set-CsExUmContact, se proporciona a Set-CsExUmContact el valor de Identity del contacto que se quiere modificar. Preste atención al formato del parámetro Identity: en este caso, hemos usado el nombre distintivo completo del objeto de contacto, que incluye un GUID generado automáticamente (generado al crear el contacto). A continuación, se define el parámetro AutoAttendant del contacto en True.