Compartir a través de

  • Artículo

Move-CsCommonAreaPhone

 

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

Mueve uno o más teléfonos de área común a un nuevo grupo de registrador.

Sintaxis

Move-CsCommonAreaPhone -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-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.

La 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.)

El cmdlet Move-CsCommonAreaPhone permite mover un teléfono de área común a un grupo de registrador nuevo.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Move-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 "Move-CsCommonAreaPhone"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

UserID

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.

Target

Requerido

FQDN

El nombre de dominio completo (FQDN) del grupo de registrador al que se debe mover el teléfono de área común; por ejemplo: atl-cs-001.litwareinc.com. Además del grupo de registrador, el objetivo también puede ser el FQDN de un proveedor de hospedaje.

DomainController

Opcional

FQDN

Permite conectarse al controlador de dominio especificado para mover el teléfono de área común. Para conectarse a un controlador de dominio específico, debe incluir el parámetro DomainController seguido del nombre del equipo (por ejemplo, atl-cs-001) o su FQDN (por ejemplo, atl-cs-001.litwareinc.com).

ProxyPool

Opcional

Nombre de dominio completo

Este parámetro se usa sólo para Microsoft Lync Online 2010. No debe usarse en una instalación interna de Lync Server.

Force

Opcional

Parámetro modificador

Si se especifica, mueve el teléfono de área común pero elimina los datos asociados, como directivas asignadas al dispositivo). Si no se especifica, el teléfono se mueve junto con los datos asociados.

PassThru

Opcional

Parámetro modificador

Permite enviar un objeto de usuario a través de la canalización que representa la cuenta de usuario que se está moviendo. De manera predeterminada, el cmdlet Move-CsCommonAreaPhone no pasa objetos por la canalizació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

Cadena de caracteres. Move-CsCommonAreaPhone acepta un valor de cadena canalizado que representa la identidad del teléfono de área común.

Tipos de valores devueltos

De forma predeterminada, Move-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 ------------------------

Move-CsCommonAreaPhone -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -Target atl-cs-001.litwareinc.com

El comando que se muestra en el Ejemplo 1 modifica el teléfono de área común con la identidad CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com para el grupo de registrador atl-cs-001.litwareinc.com.

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

Get-CsCommonAreaPhone | Where-Object {$_.DisplayName -eq "Building 31 Cafeteria"} | Move-CsCommonAreaPhone -Target atl-cs-001.litwareinc.com

En el Ejemplo 2, se mueve el teléfono de área común con el nombre para mostrar de Active Directory "Building 31 Cafeteria" al grupo de registrador atl-cs-001.litwareinc.com. Para ello, primero se llama a Get-CsCommonAreaPhone sin ningún parámetro para devolver una recopilación de todos los teléfonos de área común que están en uso en la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que elige solo los teléfonos en los que el atributo DisplayName es igual a "Building 31 Cafeteria". Luego, la recopilación filtrada se canaliza a Move-CsCommonAreaPhone, que mueve cada teléfono de la recopilación a atl-cs-001.litwareinc.com.

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

Get-CsCommonAreaPhone | Where-Object {$_.RegistrarPool -match "dublin-cs-001.litwareinc.com"} | Move-CsCommonAreaPhone -Target atl-cs-001.litwareinc.com

En el ejemplo anterior, se muestra cómo se mueven todos los teléfonos de área común que actualmente se encuentran en el grupo de registrador dublin-cs-001.litwareinc.com al grupo de registrador atl-cs-001.litwareinc.com. Para llevar a cabo esta tarea, el comando llama primero a Get-CsCommonAreaPhone sin ningún parámetro, que devuelve una recopilación de todos los teléfonos de área común configurados para usarse en la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que elige todos los teléfonos de área común en los que la propiedad RegistrarPool es igual a dublin-cs-001.litwareinc.com. Luego, la recopilación se canaliza a Move-CsCommonAreaPhone, que mueve cada teléfono de la recopilación al nuevo grupo de registrador atl-cs-001.litwareinc.com.

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

Get-CsCommonAreaPhone | Where-Object {$_.RegistrarPool -match "dublin-cs-001.litwareinc.com"} | Move-CsCommonAreaPhone -Target atl-cs-001.litwareinc.com -PassThru | Grant-CsVoicePolicy -PolicyName AtlantaVoicePolicy

El Ejemplo 4 es una variación del comando que se muestra en el Ejemplo 3; sin embargo, en este caso, los teléfonos de área común no solo se mueven a un nuevo grupo de registrador, sino que también se les asigna una nueva directiva de voz por usuario. Para hacerlo, el comando PassThru se incluye al llamar a Move-CsCommonAreaPhone; esto es necesario a fin de pasar los objetos de los teléfonos de área común a través de la canalización. (De manera predeterminada, el cmdlet Move-CsCommonAreaPhone no pasa objetos por la canalización.) Después de mover los teléfonos, los objetos del teléfono se canalizan al cmdlet Grant-CsVoicePolicy, que asigna la directiva de voz AtlantaVoicePolicy a cada uno de los teléfonos que se acaban de mover.