Compartir a través de

  • Artículo

Move-CsAnalogDevice

 

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

Mueve uno o más dispositivos analógicos a un nuevo grupo de registrador. Un dispositivo analógico es un teléfono u otro dispositivo que está conectado a una red telefónica conmutada (RTC).

Sintaxis

Move-CsAnalogDevice -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Los dispositivos analógicos pueden ser teléfonos, aparatos de fax, módems y teletipos o dispositivos de telecomunicaciones para personas con discapacidades auditivas (TTY/TTD) conectados a la red telefónica conmutada (RTC). A diferencia de los dispositivos que usan Enterprise Voice (sistema de Voz sobre IP (VoIP) que ofrece Microsoft), los dispositivos analógicos no transmiten la información mediante paquetes digitales. En lugar de eso, la información se transmite utilizando una señal continua. Esta señal se denomina señal analógica; de ahí el término “dispositivos analógicos”.

Para que los administradores puedan gestionar dispositivos analógicos, Microsoft Lync Server 2010 permite asociarlos con objetos de contacto de Active Directory. Al asociar un dispositivo analógico con un objeto de contacto, puede administrarlo asignando directivas y planes de marcado al contacto.

El cmdlet Move-CsAnalogDevice permite mover un dispositivo analógico existente a un grupo de registrador nuevo.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Move-CsAnalogDevice de forma local: RTCUniversalUserAdmins. Los permisos necesarios para ejecutar este cmdlet para sitios específicos o unidades organizativas (OU) de Active Directory determinados, se pueden asignar utilizando el cmdlet Grant-CsOUPermission. 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 "Move-CsAnalogDevice"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

UserID

Identificador único del dispositivo analógico. Los dispositivos analógicos se identifican mediante el nombre distintivo de Active Directory correspondiente al objeto del contacto asociado. Los dispositivos analógicos usan, de forma predeterminada, un GUID (identificador único global) como nombre común; por ello, la identidad de los dispositivos suele ser similar a la siguiente: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

Target

Requerido

FQDN

El nombre de dominio completo (FQDN) (por ejemplo, atl-cs-001.litwareinc.com) del grupo de registrador donde se moverá el dispositivo analógico. Además de un grupo de registrador, el destino también puede ser el FQDN de un proveedor de hospedaje.

DomainController

Opcional

FQDN

Permite conectarse al controlador de dominio especificado para mover un dispositivo analógico. 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

FQDN

Este parámetro solamente se utiliza 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 dispositivo analógico, pero elimina los datos asociados (como directivas asignadas al dispositivo). Si no se especifica, el dispositivo 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 forma predeterminada, el cmdlet Move-CsAnalogDevice no pasa objetos a través de 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-CsAnalogDevice acepta un valor de cadena transferido que representa la identidad del dispositivo analógico.

Tipos de valores devueltos

De forma predeterminada, Move-CsAnalogDevice no devuelve objetos ni valores. Sin embargo, si se incluye el parámetro PassThru, el cmdlet devolverá las instancias del objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Ejemplo

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

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

El comando mostrado en el Ejemplo 1 mueve el dispositivo analógico con Identidad CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com al grupo de registrador atl-cs-001.litwareinc.com.

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

Get-CsAnalogDevice | Where-Object {$_.DisplayName -eq "Building 14, Room 142"} | Move-CsAnalogDevice -Target atl-cs-001.litwareinc.com

En el Ejemplo 2, el dispositivo analógico que tiene el nombre para mostrar de Active Directory, "Building 14, Room 142", se mueve al grupo de registrador atl-cs-001.litwareinc.com. Para ellos, se llama primero a Get-CsAnalogDevice sin ningún parámetro, lo que devuelve una colección de todos los dispositivos analógicos en uso actualmente en la organización. A continuación, esta colección se transfiere al cmdlet Where-Object, que selecciona todos los dispositivos que tienen el nombre para mostrar "Building 14, Room 142". Esa colección filtrada se transfiere a Move-CsAnalogDevice, que mueve todos los dispositivos de la colección al grupo de registrador atl-cs-001.litwareinc.com.

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

Get-CsAnalogDevice | Where-Object {$_.DisplayName -like "Building 14*"} | Move-CsAnalogDevice -Target atl-cs-001.litwareinc.com

El comando anterior mueve todos los dispositivos analógicos que tienen un nombre para mostrar que comienza con el valor de cadena "Building 14". Para realizar esta tarea, el comando primero llama a Get-CsAnalogDevice para devolver una colección de todos los dispositivos analógicos que están en uso en la organización. A continuación, esta colección se transfiere al cmdlet Where-Object, que selecciona todos los dispositivos que tienen un nombre para mostrar que comienza con el valor de cadena "Building 14". La colección filtrada se transfiere a Move-CsAnalogDevice, que mueve todos los dispositivos de la colección al grupo de registrador atl-cs-001.litwareinc.com.