New-CsDialInConferencingDtmfConfiguration
Última modificación del tema: 2012-03-23
Crea una nueva recopilación de configuraciones de señalización tono de marcado de frecuencia múltiple (DTMF) usadas para 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
New-CsDialInConferencingDtmfConfiguration -Identity <XdsIdentity> [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-InMemory <SwitchParameter>] [-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 de tono de marcado de frecuencia múltiple (DTMF): 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.
Al instalar Lync Server 2010, se crea una recopilación global de configuraciones de DTMF para usted. Además de esta configuración global, puede usar el cmdlet New-CSDialInConferencingDtmfConfiguration para personalizar la configuración de cada sitio por separado. Por ejemplo, puede crear una nueva recopilación de configuraciones para el sitio Redmond (y sólo para este sitio) que use la tecla 4 en lugar de la tecla 6 como tecla de silenciado/no silenciado. Tenga en cuenta que cualquier opción que configure en el ámbito del sitio tiene prioridad sobre las opciones configuradas en el ámbito global. Por lo tanto, los usuarios del sitio Redmond usarán la tecla 4 como tecla de silenciado/no silenciado, a pesar de que la configuración global use la tecla 6 para hacerlo.
Solo puede tener una recopilación de configuraciones de DTMF y una recopilación global por sitio. Por ejemplo, supongamos que ya dispone de una recopilación con Identity site:Redmond y que intenta ejecutar el siguiente comando:
New- CSDialInConferencingDtmfConfiguration –Identity site:Redmond
El comando dará error porque la recopilación site:Redmond ya existe. Si desea modificar la recopilación site:Redmond, puede usar el cmdlet Set-CSDialInConferencingDtmfConfiguration o quitar la recopilación existente, y crear a continuación una nueva que use Identity site:Redmond.
Tenga en cuenta los dos puntos siguientes cuando configure valores para los comandos DTMF. Primero, sólo puede usar las teclas numéricas 0 a 9 y el asterisco (*); las demás tecla del teclado numérico (como la tecla #) no se pueden usar. (Con una excepción: la tecla CommandCharacter sólo acepta la tecla * o la tecla #). 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 quiere decir que cuando se cambian las teclas asignadas a un comando, es posible que sea necesario intercambiar las teclas que se usan para dos comandos diferentes. 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énes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet New-CsDialInConferencingDtmfConfiguration en forma local: RTCUniversalServerAdmins. 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 "New-CsDialInConferencingDtmfConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Único identificador que se asigna a la nueva recopilación de las opciones de configuración de DTMF. Como solo puede crear nuevas recopilaciones en el ámbito del sitio, la Identidad siempre será el prefijo "site:" seguido del nombre del sitio; por ejemplo "site:Redmond". |
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 presionar para silenciar o no silenciar el audio de cualquier participante en la conferencia (es decir, se activará o desactivará el audio de cualquier persona, excepto el del 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 (*). El único valor diferente permitido es #. |
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 usa para 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 |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse al ejecutar el comando. |
InMemory |
Opcional |
Parámetro modificador |
Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet. |
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-CsDialInConferencingDtmfConfiguration no acepta entradas canalizadas.
Tipos de valores devueltos
Crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -MuteUnmuteCommand 4 -AudienceMuteCommand 6
El comando del Ejemplo 1 crea un nuevo conjunto de configuraciones de DTMF para el sitio Redmond. En este ejemplo, la propiedad MuteUnmuteCommand se establece en 4 y la propiedad AudienceMuteCommand se establece en 6.
-------------------------- Ejemplo 2 ------------------------
New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -AdmitAll $Null
El comando anterior crea un nuevo conjunto de opciones de configuración de DTMF para el sitio Redmond. En este ejemplo, la propiedad AdmitAll está deshabilitada. Esto se hace al usar el parámetro AdmitAll y mediante la configuración del valor del parámetro en Null ($Null).
-------------------------- Ejemplo 3 ------------------------
$x = New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -InMemory
$x.AdmitAll = $Null
$x.MuteUnmuteCommand = 4
$x.AudienceMuteCommand = 6
Set-CSDialInConferencingDtmfConfiguration -Instance $x
En el Ejemplo se 3 muestra cómo se puede usar el parámetro InMemory para crear una instancia sólo en memoria de una recopilación de configuraciones de DTMF, cambiar estas configuraciones y usar a continuación Set-CSDialInConferencingDtmfConfiguration para crear una recopilación real con Identity site:Redmond. Para ello, el primer comando del ejemplo crea una nueva instancia de sólo en memoria de una recopilación de configuraciones de DTMF y la almacena en una variable denominada $x. Estas configuraciones existirán en la memoria únicamente. Si cierra Windows PowerShell o elimina la variable $x, las configuraciones desaparecerán y nunca se aplicarán al sitio Redmond.
Los tres comandos siguientes cambian las propiedades de esta recopilación "virtual" de configuraciones de DTMF: los comandos 2, 3 y 4 asignan valores nuevos a AdmitAll, MuteUnMuteCommand y AudienceMuteCommand respectivamente. El último comando usa a continuación Set-CSDialInConferencingDtmfConfiguration y el parámetro Instance para transformar las configuraciones virtuales almacenadas en $x en una recopilación real de opciones configuradas para el sitio Redmond.