Compartir a través de

  • Artículo

New-CsAnalogDevice

 

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

Crea un nuevo dispositivo analógico que se puede administrar mediante Microsoft Lync Server 2010. Un dispositivo analógico es un teléfono u otro dispositivo que está conectado a una red telefónica conmutada (RTC).

Sintaxis

New-CsAnalogDevice -AnalogFax <$true | $false> -Gateway <Fqdn> -LineUri <String> -OU <OUIdParameter> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

New-CsAnalogDevice -AnalogFax <$true | $false> -DN <ADObjectId> -Gateway <Fqdn> -LineUri <String> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-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 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.

Para crear dispositivos analógicos se usa el cmdlet New-CsAnalogDevice. Este cmdlet permite crear objetos de contacto para usarlos con dispositivos analógicos o asociar objetos existentes con un nuevo dispositivo. Si desea más información, consulte las descripciones de los parámetros de OU y DN en este mismo tema.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-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 "New-CsAnalogDevice"}

Parámetros

Parámetro Requerido Tipo Descripción

LineUri

Requerido

Cadena de caracteres

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

SipAddress

Opcional

Dirección SIP

Identificador único (similar a una dirección de correo electrónico) que permite al dispositivo analógico comunicarse con dispositivos SIP, como Microsoft Lync 2010. La dirección SIP debe tener el prefijo "sip:". Por ejemplo: sip:bldg14lobby@litwareinc.com.

RegistrarPool

Requerido

Cadena de caracteres

Nombre de dominio completo (FQDN) del grupo de registrador donde se hospedará el objeto de contacto. Por ejemplo: -RegistrarPool "atl-cs-001.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.

AnalogFax

Requerido

Booleano

Definir en True ($True) si el dispositivo analógico es un fax. Definir en False ($False) si el dispositivo no es un fax.

Gateway

Requerido

Cadena de caracteres

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

OU

Requerido

Nombre distintivo de Active Directory

Nombre distintivo de la unidad organizativa (OU) de Active Directory en la que se ubicará el objeto de contacto. Por ejemplo: -OU "ou=Redmond,dc=litwareinc,dc=com”.

Si incluye el parámetro OU, se creará un nuevo contacto en la unidad organizativa especificada y se le asignará automáticamente un GUID (identificador único global) como su nombre común. Como resultado, el objeto de contacto tendrá un nombre similar a: {ce84964a-c4da-4622-ad34-c54ff3ed361f}.

DN

Opcional

Nombre distintivo de Active Directory

Permite asociar un objeto de contacto de Active Directory con el dispositivo analógico. Si quiere asociar un objeto de contacto con un dispositivo analógico, use el parámetro DN seguido del nombre distintivo del contacto. Por ejemplo: -DN "cn=Building 14 Lobby,dc=litwareinc,dc=com". Debe tener en cuenta que el comando fallará si el contacto especificado no existe.

No puede usar los parámetros OU y DN en el mismo comando.

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

Ninguno. New-CsAnalogDevice no acepta la entrada transferida.

Tipos de valores devueltos

New-CsAnalogDevice crea instancias del objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Ejemplo

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

New-CsAnalogDevice -LineUri tel:+14255556001 -DisplayName "Building 14 Receptionist" -RegistrarPool redmond-Cs-001.litwareinc.com -AnalogFax $False -Gateway 192.168.0.240 -OU "ou=Telecommunications,dc=litwareinc,dc=com"

El comando del Ejemplo 1 crea un dispositivo analógico con el número de teléfono (LineUri) 1-425-555-6001. (Tenga en cuenta que el número de teléfono debe especificarse en formato E.164.) Además del parámetro -LineUri, el comando también usa los parámetros DisplayName (para definir el nombre para mostrar de Active Directory del dispositivo); RegistrarPool (para especificar el grupo de registrador); AnalogFax (definido en $False, para indicar que se trata de un teléfono y no un fax); Gateway (definido en la dirección IP de la puerta de enlace); y OU (nombre distintivo de la unidad organizativa de Active Directory en la que se creará el objeto de contacto del dispositivo).