Set-CsRgsAgentGroup
Última modificación del tema: 2012-03-23
Modifica un grupo de agentes existente de Grupo de respuesta. Un grupo de agentes es una colección de agentes asignada a una cola de Grupo de respuesta. Los agentes son usuarios asignados para responder llamadas dirigidas a una cola específica.
Sintaxis
Set-CsRgsAgentGroup -Instance <AgentGroup> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Cuando alguien llama a un número de teléfono asociado con la Aplicación de grupo de respuesta, el servicio determina en primer lugar qué flujo de trabajo corresponde al número llamado. Según la configuración del flujo de trabajo, la llamada puede enrutarse a una serie de preguntas de repuesta de voz interactiva (IVR), en las que el autor de la llamada debe responder a una o varias preguntas del tipo "¿Tiene una consulta relacionada con el hardware o con el software?". También se puede colocar la llamada en una cola de Grupo de respuesta, en la que el autor de la llamada estará en espera hasta que haya una persona designada disponible para atender la llamada. Las personas designadas para responder a llamadas se llaman agentes, y un conjunto de agentes se conoce como grupo de agentes de Grupo de respuesta. Los grupos de agentes están asociados con flujos de trabajo y pueden asociarse de manera más específica con tareas similares. Por ejemplo, el personal de asistencia técnica puede agruparse en el grupo de agentes Asistencia técnica, mientras que los agentes de atención al cliente pueden agruparse en el grupo de agentes del Help Desk.
Para crear nuevos grupos de agentes se usa el cmdlet New-CsRgsAgentGroup. Si necesita aplicar cambios a un grupo de agentes ya creado, use el cmdlet Set-RgsAgentGroup, que permite, entre otras cosas, agregar y quitar agentes individuales de un grupo. Tenga en cuenta que Set-CsRgsAgentGroup no modifica directamente las propiedades de un grupo de agentes. Para modificar un grupo, primero es necesario crear una referencia de objeto al grupo; para ello, se llama a Get-CsRgsAgentGroup para recuperar el grupo y se almacena el objeto devuelto en una variable. Una vez creada la referencia a objeto, se realizan los cambios de las propiedades del grupo en la memoria. Una vez realizadas las modificaciones, es necesario llamar a Set-CsRgsAgentGroup para escribir los cambios en el grupo de agentes real del Grupo de respuesta. Si no llama a Set-CsRgsAgentGroup, los cambios solo se aplicarán en la memoria, y desaparecerán al cerrar Windows PowerShell o eliminar la variable de referencia a objeto.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsRgsAgentGroup 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 (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 "Set-CsRgsAgentGroup"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Instance |
Requerido |
Objeto AgentGroup |
Referencia a objeto al grupo de agentes de Grupo de respuesta que se modificará. Para recuperar una referencia a objeto se usa el cmdlet Get-CsRgsAgentGroup y se asigna el valor devuelto a una variable; por ejemplo, este comando devuelve una referencia de objeto al grupo de agentes Help Desk y almacena la referencia de objeto en una variable llamada $x: $x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk " |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves que se produzcan 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.Rgs.Management.WritableSettings.AgentGroup. Set-CsRgsAgentGroup acepta instancias transferidas del objeto del grupo de agentes de Grupo de respuesta.
Tipos de valores devueltos
Set-CsRgsAgentGroup no devuelve objetos ni valores. Este cmdlet se usa para modificar instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.RoutingMethod = "RoundRobin"
Set-CsRgsAgentGroup -Instance $x
Los comandos del Ejemplo 1 modifican la propiedad RoutingMethod del grupo de agentes Help Desk de Grupo de respuesta (del servicio ApplicationServer:atl-cs-001.litwareinc.com). Para ello, el comando usa en primer lugar el cmdlet Get-CsRgsAgentGroup para recuperar el grupo de agentes Help Desk (-Name "Help Desk") de ApplicationServer:atl-cs-001.litwareinc.com. Una vez recuperado, el objeto de grupo de agentes se almacena en una variable llamada $x.
El comando 2 del ejemplo modifica el valor de la propiedad RoutingMethod. En el último comando del ejemplo, se usa el cmdlet Set-CsRgsAgentGroup para escribir estos cambios en el grupo de agentes Help Desk real.
-------------------------- Ejemplo 2 ------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.DistributionGroupAddress = "helpdesk@litwareinc.com"
Set-CsRgsAgentGroup -Instance $x
En el Ejemplo 2 se muestra cómo cambiar el grupo de distribución asignado a un grupo de agentes de Grupo de respuesta. Para ello, primero se usa Get-CsRgsAgentGroup para devolver el grupo de agentes que se modificará; en este ejemplo, es el grupo Help Desk (-Name "Help Desk ") del servicio ApplicationServer:atl-cs-001.litwareinc.com. Cuando Get-CsRgsAgentGroup ha devuelto este grupo, el objeto resultante se almacena en una variable llamada $x.
El segundo comando del ejemplo asigna un nuevo valor (helpdesk@litwareinc.com) a la propiedad DistributionGroupAddress. Una vez asignado el nuevo valor, se usa Set-CsRgsAgentGroup para escribir los cambios en el grupo Help Desk en ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Ejemplo 3 ------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.AgentsByUri.Add("sip:kenmyer@litwareinc.com")
Set-CsRgsAgentGroup -Instance $x
Los comandos del Ejemplo 3 muestran cómo agregar un agente al grupo de agentes Help Desk de Grupo de respuesta. Para ello, se usa en primer lugar Get-CsRgsAgentGroup para devolver el grupo de agentes Help Desk (-Name "Help Desk") del servicio ApplicationServer:atl-cs-001.litwareinc.com. El objeto recuperado se almacena en una variable llamada $x.
En el segundo comando, se usa el método Add para agregar un agente a la propiedad AgentsByUri; para ello, se especifica la dirección SIP del nuevo agente ("sip:kenmyer@litwareinc.com"). En el comando 3, se usa Set-CsRgsAgentGroup para escribir los cambios (es decir, para agregar el nuevo agente) en el grupo Help Desk. Si no se llama a Set-CsRgsAgentGroup, los cambios solo se aplicarán en la memoria y no se aplicarán al grupo de agentes real.
-------------------------- Ejemplo 4 ------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.AgentsByUri.Remove("sip:kenmyer@litwareinc.com")
Set-CsRgsAgentGroup -Instance $x
En el Ejemplo 4, se quita un agente del grupo de agentes Help Desk de Grupo de respuesta del servicio ApplicationServer:atl-cs-001.litwareinc.com. Para ello, se usa en primer lugar Get-CsRgsAgentGroup para devolver el grupo de agentes Help Desk (-Name "Help Desk") de ApplicationServer:atl-cs-001.litwareinc.com. El objeto de grupo de agentes recuperado se almacena en una variable llamada $x.
Una vez recuperado el grupo de agentes, se usa el método Remove para quitar un agente (el agente con la dirección SIP "sip:kenmyer@litwareinc.com") del grupo. En el comando 3 se llama a Set-CsRgsAgentGroup para escribir los cambios en el grupo, es decir, para quitar el agente. Si no se llama a Set-CsRgsAgentGroup, los cambios solo se aplicarán en la memoria y no se aplicarán al grupo de agentes real; solo se quitará el agente si se llama a Set-CsRgsAgentGroup.