Set-CsDialInConferencingDtmfConfiguration
Última modificación del tema: 2012-03-27
Modifica la configuración de señalización tono de marcado de frecuencia múltiple (DTMF) usada para las conferencias de acceso telefónico local. El DTMF permite a los usuario que obtengan acceso telefónico a una conferencia controlar la configuración de la conferencia (como activar o desactivar el audio o bloquear y desbloquear la conferencia) mediante el teclado de su teléfono.
Sintaxis
Set-CsDialInConferencingDtmfConfiguration [-Identity <XdsIdentity>] [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-LockUnlockConferenceCommand <String>] [-MuteUnmuteCommand <String>] [-PrivateRollCallCommand <String>] [-WhatIf [<SwitchParameter>]]
Set-CsDialInConferencingDtmfConfiguration [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-Instance <PSObject>] [-LockUnlockConferenceCommand <String>] [-MuteUnmuteCommand <String>] [-PrivateRollCallCommand <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Microsoft Lync Server 2010 permite a los usuarios unirse a conferencias obteniendo acceso a través del teléfono. Los usuarios de acceso telefónico no puede ver vídeos ni intercambiar mensajes instantáneos con el resto de asistentes de la conferencia, pero pueden participar por completo en la parte de audio de la reunión.
Además de poder unirse a conferencias, los usuarios pueden administrar partes determinadas de las conferencias con el teclado de su teléfono. (Las opciones de configuración específicas de la conferencia que los usuarios pueden administrar dependen de si el usuario es moderador.) Por ejemplo, de forma predeterminada los usuarios pueden pulsar la tecla 6 del teclado para activar o desactivar el audio por su cuenta. Los participantes pueden reproducir en privado los nombres de todos los asistentes a la reunión, mientras que los moderadores pueden activar o desactivar el audio de todos los participantes de la reunión, así como habilitar y deshabilitar el anuncio que se reproduce cada vez que alguien se une a la conferencia o la abandona.
La posibilidad de realizar selecciones como éstas usando el teclado de un teléfono se denomina señalización DTMF (tono de marcado de frecuencia múltiple): si alguna vez ha marcado un número de teléfono y se le ha pedido que haga algo parecido a: "Pulse 1 para inglés o pulse 2 para español", ha usado la señalización DTMF.
El cmdlet Set-CsDialInConferencingDtmfConfiguration permite modificar las teclas usadas para activar los comandos admitidos en una conferencia de acceso telefónico local de Lync Server 2010.
Cuando modifique los comandos de DTMF, debe tener dos cosas en cuenta. En primer lugar, solo puede usar las teclas numéricas del 0 al 9, el resto de teclas que pueda tener su teclado (como la tecla #) no están permitidas. Hay una excepción a esa regla: el parámetro CommandCharacter solo permite usar la tecla asterisco (*) o la tecla almohadilla (#); no es posible asignar un valor numérico al parámetro CommandCharacter. Sin embargo, todos los demás parámetros de comando solo aceptan valores numéricos.
En segundo lugar, los comandos deben tener asignadas teclas únicas; por ejemplo, la tecla 4 no se puede usar para activar y desactivar el audio, y para bloquear y desbloquear una conferencia. Esto significa que al modificar las teclas asignadas a un comando, es posible que le interese cambiar las teclas usadas por dos comandos distintos. Por ejemplo, si quiere asignar la tecla 4 a EnableDisableAnnouncementsCommand (valor predeterminado: 9), en el mismo comando, tendrá que asignar la tecla 9 a AudienceMuteCommand.
Para deshabilitar un comando, defina su valor en Null ($Null).
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsDialInConferencingDtmfConfiguration de forma local: RTCUniversalServerAdmins. 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 "Set-CsDialInConferencingDtmfConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Cadena de caracteres |
Indica el identificador único de la recopilación de opciones de configuración de DTMF que quiere modificar. Para hacer referencia a la configuración global, use esta sintaxis: -Identity global. Para hacer referencia a una recopilación configurada en el ámbito de sitio, use una sintaxis similar a ésta: -Identity site:Redmond. Tenga en cuenta que no puede usar caracteres comodín para especificar una identidad. Si no se especifica este parámetro, Set-CsDialInConferencingDtmfConfiguration modificará la configuración global de DTMF. |
Instance |
Opcional |
Objeto DialInConferencingDtmfConfiguration |
Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales. |
AdmitAll |
Opcional |
Cadena de caracteres |
Indica la tecla que se debe pulsar para permitir a todos los usuarios que estén en la sala de espera unirse de forma inmediata a la conferencia. El valor predeterminado es 8. |
AudienceMuteCommand |
Opcional |
Cadena de caracteres |
Indica la tecla que un moderador puede pulsar para activar el silencio de todos los participantes de la conferencia (es decir, se silenciará a todos los participantes excepto al moderador). La tecla predeterminada es 4. |
CommandCharacter |
Opcional |
Cadena de caracteres |
Indica la tecla que se debe pulsar al inicio de un comando. La tecla predeterminada es el asterisco (*), aparte de este valor, el único permitido es la tecla almohadilla (#). |
EnableDisableAnnouncementsCommand |
Opcional |
Cadena de caracteres |
Indica la tecla que se debe pulsar para habilitar o deshabilitar los anuncios cada vez que alguien se une a la conferencia o la abandona. La tecla predeterminada es 9. |
HelpCommand |
Opcional |
Cadena de caracteres |
Indica la tecla que se debe pulsar para reproducir en privado una descripción de todos los comandos de DTMF. La tecla predeterminada es 1. |
LockUnlockConferenceCommand |
Opcional |
Cadena de caracteres |
Indica la tecla que se debe pulsar para bloquear o desbloquear una conferencia. Si una conferencia está bloqueada, ningún participante nuevo podrá unirse a la conferencia, por lo menos hasta que la conferencia no se haya desbloqueado. La tecla predeterminada es 7. |
MuteUnmuteCommand |
Opcional |
Cadena de caracteres |
Indica la tecla que se presiona para silenciar o no silenciar el audio; la misma tecla se emplea para alternar entre silenciar y no silenciar el audio. La tecla predeterminada es 6. |
PrivateRollCallCommand |
Opcional |
Cadena de caracteres |
Indica la tecla que se debe pulsar para reproducir en privado el nombre de todos los participantes de la conferencia. La tecla predeterminada es 3. |
Force |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir al ejecutar el comando. |
|
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
Objeto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration. Set-CsDialInConferencingDtmfConfiguration acepta las instancias transferidas del objeto de configuración de DTMF para conferencias de acceso telefónico local.
Tipos de valores devueltos
Set-CsDialInConferencingDtmfConfiguration no devuelve ni valores ni objetos. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Set-CsDialInConferencingDtmfConfiguration -Identity global -EnableDisableAnnouncementsCommand 4 -AudienceMuteCommand 9
El comando que se muestra en el Ejemplo 1 cambia las teclas asignadas al comando para habilitar y deshabilitar los anuncios (valor predeterminado: 9) y al comando para activar y desactivar el silencio de todos los participantes (valor predeterminado: 4) para la configuración global de DTMF. Para ello, se usan dos parámetros diferentes: EnableDisableAnnoucementsCommand, al que se asigna el valor 4, y AudienceMuteCommand, con el valor 9. Puesto que no se especifica ninguna identidad, los cambios afectarán a la configuración global de DTMF.
-------------------------- Ejemplo 2 ------------------------
Set-CsDialInConferencingDtmfConfiguration -Identity site:Redmond -EnableDisableAnnouncementsCommand 4 -AudienceMuteCommand 9
El comando mostrado en el Ejemplo 2 es una variación del comando mostrado en el primer ejemplo. No obstante, en este caso los cambios afectan a las opciones de configuración de DTMF que tienen la identidad site:Redmond.
-------------------------- Ejemplo 3 ------------------------
Set-CsDialInConferencingDtmfConfiguration -Identity "site:Redmond" -PrivateRollCallCommand $Null
El comando mostrado en el Ejemplo 3 deshabilita el comando de asistencia (la posibilidad de reproducir una lista de todos los participantes a la conferencia) para el sitio Redmond. Para deshabilitar este comando, se incluye el parámetro PrivateRollCallCommand con el valor $Null. Esto significa que no se asociará ninguna tecla del teclado con el comando y, por tanto, el comando no estará disponible para los usuarios.
-------------------------- Ejemplo 4 ------------------------
Get-CsDialInConferencingDtmfConfiguration -Filter "site:*" | Set-CsDialInConferencingDtmfConfiguration -PrivateRollCallCommand $Null
El Ejemplo 4 es una variación del Ejemplo 3: en este ejemplo, se deshabilita el comando de asistencia para todas las opciones de configuración de DTMF definidas en el ámbito del sitio. Para ello, el comando usa primero Get-CsDialInConferencingDtmfConfiguration y el parámetro Filter para devolver una colección de todas las opciones configuradas en el ámbito del sitio. El valor de filtro "site:*" restringe los datos devueltos a las configuraciones cuya identidad comience con los caracteres "site:". A continuación, la colección filtrada se transfiere a Set-CsDialInConferencingDtmfConfiguration que establece el valor de la propiedad PrivateRollCallCommand en un valor nulo ($Null).