Compartir a través de

  • Artículo

Set-CsAnalogDevice

 

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

Modifica un dispositivo existente de la recopilación de dispositivos analógicos que se pueden administrar mediante Microsoft Lync Server 2010. Un dispositivo analógico es un teléfono o dispositivo de fax conectado a la red telefónica conmutada (RTC).

Sintaxis

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

Descripción detallada

Los dispositivos analógicos pueden ser teléfonos, aparatos de fax, módems y dispositivos TTY/TTD (Teletype/Telecommunication Devices for the Deaf) conectados a la red telefónica conmutada (RTC). A diferencia de los dispositivos que usan Enterprise Voice (es decir, el sistema de Microsoft para el protocolo de voz sobre IP (VoIP)), los dispositivos analógicos no transmiten la información mediante paquetes digitales. En su lugar, la información se transmite a través de señales continuas. Esta señal se denomina señal analógica; de ahí el término “dispositivos analógicos”.

Para que los administradores puedan controlar dispositivos analógicos, 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 Set-CsAnalogDevice proporciona una forma de modificar las propiedades de los objetos de contacto asociados con dispositivos analógicos. Por ejemplo, es posible cambiar el nombre para mostrar de Active Directory del contacto o el Identificador uniforme de recursos (URI) asociado con el dispositivo.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet Set-CsAnalogDevice de forma local: RTCUniversalUserAdmins. Los permisos para ejecutar este cmdlet para sitios específicos o unidades organizacionales (OU) específicas de Active Directory pueden asignarse por medio 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-CsAnalogDevice"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Parámetro de Id. de usuario

Identificador único para el dispositivo analógico objeto de modificación. Los dispositivos analógicos se identifican mediante el nombre distintivo (DN) de Active Directory correspondiente al objeto del contacto asociado. De forma predeterminada, los dispositivos analógicos usan 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. Debido a esto, es posible que resulte más fácil modificar los dispositivos analógicos mediante el cmdlet Get-CsAnalogDevice para devolver los objetos de los dispositivos analógicos y después transferir esos objetos a Set-CsAnalogDevice.

Gateway

Opcional

Cadena de caracteres

Dirección IP de la puerta de enlace RTC que usará el dispositivo analógico.

AnalogFax

Opcional

Booleano

Definir en True ($True) si el dispositivo analógico es un fax. Se establece en False ($False), si el dispositivo no es una máquina de fax.

LineURI

Opcional

Cadena de caracteres

Número de teléfono del dispositivo analógico. El 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 al dispositivo analógico comunicarse con dispositivos SIP como, por ejemplo, Microsoft Lync 2010. La dirección SIP debe tener el prefijo "sip:". Por ejemplo: sip:bldg14lobby@litwareinc.com.

DisplayName

Opcional

Cadena de caracteres

Configura el nombre para mostrar de Active Directory del dispositivo analógico.

DisplayNumber

Opcional

Cadena de caracteres

El número de teléfono tal y como se muestra en 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.

DomainController

Opcional

Parámetro modificador

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

Enabled

Opcional

True

Si está definido en True ($True), el dispositivo analógico puede utilizarse con Lync Server 2010.

EnterpriseVoiceEnabled

Opcional

Booleano

Indica si el objeto de contacto del dispositivo analógico está habilitado para Enterprise Voice, la solución de VoIP de Microsoft. 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.

PassThru

Opcional

Parámetro modificador

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

WhatIf

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.OCSADAnalogDeviceContact. Set-CsAnalogDevice acepta las instancias canalizadas del objeto del dispositivo analógico.

Tipos de valores devueltos

De forma predeterminada, Set-CsAnalogDevice 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.OCSADAnalogDeviceContact.

Ejemplo

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

Set-CsAnalogDevice -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -LineUri "TEL:+14255551298"

El comando anterior cambia el valor de la propiedad LineUri del dispositivo analógico que tiene la identidad CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

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

Get-CsAnalogDevice -Filter {Gateway -eq "192.168.0.240"} | Set-CsAnalogDevice -Gateway "192.168.1.100"

El comando que aparece en el Ejemplo 2 modifica la puerta de enlace de cada dispositivo analógico que está usando la puerta de enlace 192.168.0.240. Para ello, se llama a Get-CsAnalogDevice junto con el parámetro Filter; el valor de filtro {Gateway -eq "192.168.0.240"} garantiza que solo se devuelvan dispositivos cuyo Gateway sea igual a (-eq) 192.168.0.240. A continuación, esta recopilación se redirecciona a Set-CsAnalogDevice, que toma cada elemento de la recopilación y modifica el valor de la propiedad Gateway a 192.168.1.100.