Get-CsRgsConfiguration
Última modificación del tema: 2012-03-23
Devuelve información sobre los valores de configuración de la Aplicación de grupo de respuesta.
Sintaxis
Get-CsRgsConfiguration -Identity <RgsIdentity>
Descripción detallada
La Aplicación de grupo de respuesta permite enrutar automáticamente las llamadas telefónicas a entidades, como una línea de asistencia técnica o atención al cliente. Cuando alguien llama a un número telefónico específico, la llamada puede enrutarse directamente al conjunto correspondiente de agentes de Grupo de respuesta. La llamada también puede enrutarse a una cola de respuesta de voz interactiva (IVR). En dicha cola, el autor de la llamada deberá responder a una serie de preguntas, como "¿Está llamando en relación a un pedido realizado?", y, a continuación, según las respuestas especificadas, se enrutará la llamada a la cola de Grupo de respuesta correspondiente.
El cmdlet Get-CsRgsConfiguration permite devolver información sobre cómo está configurada la Aplicación de grupo de respuesta. Tenga en cuenta que, de forma predeterminada, este cmdlet solo devuelve información sobre una instancia de la Aplicación de grupo de respuesta cada vez. Por ejemplo, si tiene instalaciones independientes de la Aplicación de grupo de respuesta (una en ApplicationServer:atl-cs-001.litwareinc.com y otra en ApplicationServer:dublin-cs-001.litwareinc.com), deberá realizar llamadas independientes a Get-CsRgsConfiguration para devolver información sobre cada instancia de Grupo de respuesta. La sección de ejemplos de este tema muestra cómo solucionar este problema.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsRgsConfiguration de forma local: RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluidos los roles RBAC personalizados que haya creado usted mismo), ejecute el siguiente comando desde el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsRgsConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Rgs |
Nombre del servicio en que se hospeda la configuración de Grupo de respuesta; por ejemplo: -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com". Si no incluye este parámetro, Get-CsRgsConfiguration le solicitará que especifique un valor de identidad. |
Tipos de entrada
Cadena de caracteres. Get-CsRgsConfiguration acepta un valor de cadena de caracteres que representa la identidad de los valores de configuración de Grupo de respuesta.
Tipos de valores devueltos
Get-CsRgsConfiguration devuelve instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.ServiceSettings.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"
El Ejemplo 1 devuelve los valores de configuración de Grupo de respuesta del servicio ApplicationServer:atl-cs-001.litwareinc.com. Como sólo puede haber una colección de configuraciones por servicio, este comando nunca devolverá más de un elemento.
-------------------------- Ejemplo 2 ------------------------
(Get-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com").DisableCallContext
El comando anterior devuelve el valor de una única propiedad (DisableCallContext) de los valores de configuración de Grupo de respuesta del servicio ApplicationServer:atl-cs-001.litwareinc.com. Para ello, primero se usa Get-CsRgsConfiguration para recuperar todos los valores de propiedad de los valores de configuración de Grupo de respuesta de ApplicationServer:atl-cs-001.litwareinc.com. Tenga en cuenta que el comando está entre paréntesis; de este modo se garantiza que Windows PowerShell devuelve todos los valores de propiedades antes de realizar ninguna otra acción.
Una vez devueltos los valores de propiedades, se usa una "notación de punto" estándar para mostrar el valor de la propiedad DisableCallContext (y sólo el valor de dicha propiedad). La notación de punto estándar consiste en el objeto seguido de un punto y a continuación el nombre de la propiedad que se mostrará. Por ejemplo, para mostrar el valor de la propiedad AgentRingbackGracePeriod (y solo el valor de dicha propiedad), puede usar este comando:
(Get-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com").AgentRingbackGracePeriod.
-------------------------- Ejemplo 3 ------------------------
Get-CsService -ApplicationServer | Where-Object {$_.Applications -contains "urn:application:RGS"} | ForEach-Object {Get-CsRgsConfiguration -Identity $_.Identity}
El comando del Ejemplo 3 muestra cómo se devuelve información de la configuración de Grupo de respuesta de todos los equipos que ejecutan el Servicio de aplicaciones que hospeda una instancia de la aplicación de Grupo de respuesta. Para realizar esto, el comando primero usa el cmdlet Get-CsService y el parámetro ApplicationServer para devolver información sobre todos los servidores de la organización que ejecutan el Servicio de aplicaciones. A continuación, la colección se transfiere al cmdlet Where-Object, que únicamente selecciona los servidores cuya propiedad Applications contiene la aplicación "urn:application:RGS"; este valor indica que la Aplicación de grupo de respuesta se está ejecutando en el servidor.
A su vez, estos servidores se transfieren al cmdlet ForEach-Object. ForEach-Object toma cada servidor de la colección y usa Get-CsRgsConfiguration para devolver información sobre la configuración de Grupo de respuesta de cada servidor.