Compartir a través de

  • Artículo

Set-CsCommonAreaPhone

 

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

Modifica los valores de propiedades de un teléfono de área común administrado por Microsoft Lync Server 2010. Los teléfonos de área común son teléfonos ubicados en las salas de espera de edificios, salas de empleados u otras áreas donde pueden ser usados por gran cantidad de personas y para usos diversos.

Sintaxis

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

Descripción detallada

Los teléfonos de área común son teléfonos IP que no están asociados a un usuario individual. En lugar de estar ubicados en la oficina de algún empleado, los teléfonos de área común suelen encontrarse en salas de espera de edificios, cafeterías, salas de empleados, salas de reuniones y otros lugares donde pueden confluir una gran cantidad de personas. Esto supone un reto de administración para los administradores; esto se debe a que el uso del teléfono en Lync Server 2010 suele mantenerse con directivas de voz y planes de marcado que se asignan a usuarios individuales. Los teléfonos de área común no tienen usuarios individuales asignados.

Una solución a este reto es crear objetos de contacto de Active Directory para todos los teléfonos de área común. (Dichos objetos de contacto se pueden crear con el cmdlet New-CsCommonAreaPhone). Del mismo modo que sucede con las cuentas de usuario, es posible asignar directivas y planes de marcado a los objetos de contacto. Como resultado, podrá mantener el control de los teléfonos de área común, aunque estos teléfonos no estén asociados con un usuario concreto. Por ejemplo, si no quiere que la gente tenga la posibilidad de transferir o estacionar llamadas desde un teléfono de área común, puede crear una directiva de voz que prohíba las transferencias y el estacionamiento de llamadas y, a continuación, asignarla al teléfono de área común. (O, mejor dicho, al objeto de contacto que representa el teléfono de área común.) Este comando asigna la directiva de voz CommonAreaPhoneVoicePolicy a todos sus teléfonos de área común:

Get-CsCommonAreaPhone | Grant-CsVoicePolicy –PolicyName "CommonAreaPhoneVoicePolicy"

El cmdlet Set-CsCommonAreaPhone permite modificar las propiedades de los objetos de contacto asociados con los teléfonos de área común. Entre otras cosas, puede cambiar el nombre para mostrar de Active Directory del contacto, o el URI de línea asociado con el teléfono. También puede usar el parámetro Enabled para habilitar y deshabilitar la cuenta para su uso con Lync Server 2010.

Además, puede configurar "áreas de trabajo sin asignar" para los teléfonos de áreas comunitarias; para ello, utilice los cmdlets CsClientPolicy. Cuando se indica un teléfono para un área de trabajo no asignada, los usuarios pueden iniciar sesión en el teléfono con sus credenciales Lync Server. Entre otras cosas, esto les ofrece un acceso fácil a sus contactos. Consulte el tema de ayuda del cmdlet Set-CsClientPolicy para obtener más información.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsCommonAreaPhone localmente: RTCUniversalUserAdmins. Se pueden asignar permisos para ejecutar este cmdlet para sitios específicos o unidades organizativas (OU) de Active Directory por medio del uso del cmdlet Grant-CsOUPermission. 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 "Set-CsCommonAreaPhone"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Parámetro de Id. de usuario

Identificador único del teléfono de área común. Los teléfonos de área común se identifican usando el nombre distintivo de Active Directory del objeto de contacto asociado. De forma predeterminada, los teléfonos de área común, usan un GUID (identificador único global) como nombre común; esto significa que los teléfonos normalmente tienen una identidad similar a ésta: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com. Por este motivo, es posible que le resulte más fácil recuperar los teléfonos de área común usando el cmdlet Get-CsCommonAreaPhone y, a continuación, transfiriendo los objetos devueltos a Set-CsCommonAreaPhone.

Enabled

Opcional

Cadena de caracteres

Indica si el objeto de contacto del teléfono de área común se ha habilitado para Lync Server 2010.

Si se deshabilita un contacto con el parámetro Enabled, la información asociada con esa cuenta se conservará (incluidas las directivas asignadas, si el usuario está habilitado para Enterprise Voice, control remoto de llamadas e integración de correo de voz). Si se vuelve a habilitar la cuenta más adelante con el parámetro Enabled, la información asociada con la cuenta se restaurará.

Description

Opcional

Cadena de caracteres

Permite modificar el atributo de descripción de Active Directory para el teléfono de área común. Esto permite proporcionar información adicional sobre el teléfono; por ejemplo, puede proporcionar detalles sobre quién contactar si surgen problemas con el teléfono.

DisplayName

Opcional

Cadena de caracteres

Permite modificar el nombre para mostrar de Active Directory del teléfono de área común.

DisplayNumber

Opcional

Cadena de caracteres

Número de teléfono tal como aparece en Microsoft Lync 2010. Puede dar el formato que prefiera a la propiedad DisplayNumber; por ejemplo, 1-800-555-1234, 1-(800)-555-1234, 1.800.555.1234, etc. Al elegir un número para mostrar, tenga en cuenta que este número aparecerá en la pantalla del teléfono de área común sólo si se puede normalizar el número. (Normalización es el proceso de traducción de cadenas de números en un formato de número telefónico estándar). Si no existe una regla de normalización para el formato de número telefónico usado al configurar el número para mostrar, la pantalla del teléfono de área común mostrará el valor de la propiedad LineUri en lugar del valor de la propiedad DisplayNumber.

DomainController

Opcional

Cadena de caracteres

Permite conectarse al controlador de dominio especificado para modificar la información de contacto. 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 (FQDN), por ejemplo: atl-mcs-001.litwareinc.com.

EnterpriseVoiceEnabled

Opcional

Booleano

Indica si el objeto de contacto del teléfono de área común se ha habilitado para Enterprise Voice, la solución de Microsoft que usa el protocolo de voz sobre IP (VoIP). Con Enterprise Voice, las llamadas telefónicas se pueden realizar a través de Internet, en lugar de usar la red telefónica estándar.

LineUri

Opcional

Cadena de caracteres

Número de teléfono del teléfono de área común. El identificador uniforme de recursos (URI) de línea debe especificarse en el formato E.164 y con el prefijo "TEL:". Por ejemplo: TEL:+14255551297. Los números de extensión deben agregarse al final del URI de línea, por ejemplo: TEL:+14255551297; ext=51297.

SipAddress

Opcional

Dirección SIP

Identificador único que permite que el teléfono de área común se comunique con dispositivos SIP, como Lync 2010. La dirección SIP debe tener el prefijo sip: e incluye un dominio SIP válido. Por ejemplo: sip:bldg14lobby@litwareinc.com.

PassThru

Opcional

Parámetro modificador

Devuelve un objeto que representa el teléfono de área común.

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

Tipos de valores devueltos

De manera predeterminada, Set-CsCommonAreaPhone no devuelve ningún valor ni objeto. Sin embargo, si incluye el parámetro PassThru, el cmdlet devolverá instancias del objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact.

Ejemplo

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

Get-CsCommonAreaPhone -Filter {LineUri -eq "tel:+14255556710"} | Set-CsCommonAreaPhone -DisplayName "Employee Lounge"

En el Ejemplo 1, se modifica el nombre para mostrar de Active Directory para el teléfono de área común con el número de teléfono 1-425-555-6710. Para ello, primero se llama a Get-CsCommonAreaPhone con el parámetro Filter; el valor de filtro {LineUri -eq "tel:+14255556710"} limita los datos devueltos al teléfono de área común cuya propiedad LineUri sea igual a +14255556710. A continuación, el objeto devuelto se transfiere a Set-CsCommonAreaPhone, que establece el valor de la propiedad DisplayName en "Employee Lounge".

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

Get-CsCommonAreaPhone | Set-CsCommonAreaPhone -Enabled $True

El comando mostrado en el Ejemplo 2 habilita todos los teléfonos de área común actualmente configurados para uso en la organización. Para llevar a cabo esta tarea, el comando llama a Get-CsCommonAreaPhone sin ningún parámetro para devolver una recopilación de todos los teléfonos de área común. A continuación, esta recopilación se transfiere al cmdlet Set-CsCommonAreaPhone, que establece el valor de la propiedad Enabled en True para todos los elementos de la recopilación.

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

Get-CsCommonAreaPhone -Filter {Description -eq $Null} | Set-CsCommonAreaPhone -Description "Common area phone"

El comando anterior agrega una descripción genérica a todos los teléfonos de área común que no tienen asignado ningún valor en la propiedad Description. Para ello, se llama a Get-CsCommonAreaPhone con el parámetro Filter; el valor de filtro {Description -eq $Null} garantiza que los únicos elementos devueltos sean teléfonos de área común cuya propiedad Description sea igual a un valor nulo. A continuación, la recopilación filtrada se transfiere a Set-CsCommonAreaPhone, que asigna la descripción genérica "Common area phone" a todos los elementos de la recopilación.