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).
Vea también
Otros recursos
Get-CsAnalogDevice
Move-CsAnalogDevice
Remove-CsAnalogDevice
Set-CsAnalogDevice