Get-CsDialInConferencingDtmfConfiguration
Última modificación del tema: 2012-03-23
Devuelve la configuración de señalización de tono de marcado de frecuencia múltiple (DTMF) que se usa para las conferencias de acceso telefónico. DTMF permite a los usuarios que participan por teléfono en una conferencia controlar la configuración de la conferencia (por ejemplo, activar y desactivar el audio o bloquear y desbloquear la conferencia) mediante el teclado numérico del teléfono.
Sintaxis
Get-CsDialInConferencingDtmfConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsDialInConferencingDtmfConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Descripción detallada
Microsoft Lync Server 2010 permite a los usuarios participar en conferencias por acceso telefónico. Los usuarios de acceso telefónico no pueden ver vídeo ni intercambiar mensajes instantáneos con otros asistentes a la conferencia, pero pueden participar completamente 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 de las conferencias que puede administrar un usuario dependen de si es o no moderador). Por ejemplo, de forma predeterminada, los usuarios pueden presionar la tecla 6 del teclado numérico para activar o desactivar su audio. Los participantes pueden reproducir en privado los nombres de todos los demás asistentes a la reunión, mientras que los moderadores pueden, por ejemplo, activar y desactivar el audio de todos los participantes en la reunión, y habilitar o deshabilitar el anuncio que se reproduce cada vez que alguien se une a una conferencia o la abandona.
La posibilidad de realizar selecciones 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", habrá usado la señalización DTMF. El cmdlet Get-CsDialInConferencingDtmfConfiguration permite recuperar una lista de todos los comandos de DTMF disponibles, además de las teclas que se usan para ejecutarlos.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsDialInConferencingDtmfConfiguration localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsDialInConferencingDtmfConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Cadena de caracteres |
Indica el identificador único de la colección de configuración de DTMF que desea devolver. Para hacer referencia a la configuración global, use esta sintaxis: -Identity global. Para hacer referencia a una colección configurada en el ámbito de sitio, use la sintaxis siguiente: -Identity site:Redmond. Tenga en cuenta que no se pueden utilizar comodines al especificar una Identidad. Si necesita usar caracteres comodín, use el parámetro Filter. Si no se especifica este parámetro, Get-CsDialInConferencingDtmfConfiguration devolverá una colección de todas las opciones de configuración de DTMF que se usan en la organización. |
Filter |
Opcional |
Cadena de caracteres |
Permite usar caracteres comodín para devolver una colección (o varias) de opciones de configuración de DTMF. Para devolver una colección de todas las opciones configuradas en el ámbito de sitio, use esta sintaxis: -Filter site:*. Para devolver una colección de todas las configuraciones que tengan el valor de cadena de caracteres "EUROPA" en cualquier ubicación del valor Identity (la única propiedad que se puede filtrar), use esta sintaxis: -Filter *EUROPA*. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera los datos de configuración de DTMF a partir de una réplica local de Almacén de administración central en lugar de hacerlo directamente desde Almacén de administración central. |
Tipos de entrada
Ninguno. Get-CsDialInConferencingDtmfConfiguration no acepta entradas transferidas.
Tipos de valores devueltos
Get-CsDialInConferencingDtmfConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsDialInConferencingDtmfConfiguration -Identity site:Redmond
El comando que se muestra en el Ejemplo 1 devuelve la configuración de DTMF del sitio Redmond.
-------------------------- Ejemplo 2 ------------------------
Get-CsDialInConferencingDtmfConfiguration | Select-Object Identity, HelpCommand
El ejemplo 2 devuelve una colección de toda las opciones de configuración de DTMF y, a continuación, muestra el valor de la tecla que hay que presionar para reproducir en privado una descripción de los comandos de DTMF. Para ello, se llama a Get-CsDialInConferencingDtmfConfiguration, que devuelve una colección de todos los valores de propiedad de toda la configuración de DTMF que se está usando actualmente en la organización. A continuación, esta colección se transfiere al cmdlet Select-Object, que extrae dos propiedades (Identity y HelpCommand) para mostrarlas en pantalla.
-------------------------- Ejemplo 3 ------------------------
Get-CsDialInConferencingDtmfConfiguration -Filter "site:*"
El comando que se muestra en el Ejemplo 3 devuelve toda la configuración de DTMF que se ha configurado en el ámbito de sitio. Para ello, se incluye el parámetro Filter y el valor de filtro "site:*". El valor de filtro limita los datos devueltos para obtener solo las configuraciones cuya Identidad comience con los caracteres "site:". Por definición, se trata de opciones configuradas en el ámbito de sitio.
-------------------------- Ejemplo 4 ------------------------
Get-CsDialInConferencingDtmfConfiguration | Where-Object {$_.AdmitAll -ne 8}
El comando anterior devuelve todas las opciones de configuración de DTMF donde la propiedad AdmitAll no es igual a 8 (el valor predeterminado). Para hacerlo, se llama primero a Get-CsDialInConferencingDtmfConfiguration sin ningún parámetro para devolver una colección de todas las configuraciones de DTMF que se usan actualmente. A continuación, la colección se transfiere al cmdlet Where-Object, que extrae solo las configuraciones donde la propiedad AdmitAll no sea igual a 8.