Compartir a través de

  • Artículo

Set-CsRgsHoursOfBusiness

 

Última modificación del tema: 2012-03-23

Configura un conjunto de horarios laborales de Grupo de respuesta. Los conjuntos de horarios laborales se usan para indicar los días de la semana y las horas del día en que los agentes de Grupo de respuesta están disponibles para responder a llamadas.

Sintaxis

Set-CsRgsHoursOfBusiness -Instance <BusinessHours> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Para que los autores de llamadas reciban la mejor atención posible, la Aplicación de grupo de respuesta permite definir con precisión cuándo los agentes de Grupo de respuesta están disponibles para responder a llamadas y cuándo no. Con la Aplicación de grupo de respuesta puede definir el horario laboral, que indica los días de la semana y las horas del día en que los agentes están disponibles para responder a llamadas. Por ejemplo, si su organización tiene un horario de atención de 9:00 a. m. a 5:00 p. m. de lunes a viernes, puede configurar un horario laboral para indicar que los agentes están disponibles para responder a llamadas en dicho horario; y, por extensión, que no están disponibles, por ejemplo, un jueves a las 8:00 p. m. o un domingo a las 2:30 p. m.

Los conjuntos de horarios laborales se crean con el cmdlet New-CsRgsHoursOfBusiness. Una vez creados, los conjuntos pueden modificarse con el cmdlet Set-CsRgsHoursOfBusiness. Normalmente, los cambios consisten en cambiar las horas laborales de uno o varios días de la semana. Por ejemplo, si el servicio de asistencia estaba abierto hasta las 5:00 p. m. los viernes, pero con el nuevo horario estará disponible hasta las 7:00 p. m. los viernes, deberá modificar el horario laboral de los viernes. Si el servicio de asistencia estaba abierto los sábados pero con el nuevo horario estará cerrado los sábados, deberá modificar el horario laboral de los sábados. (Para indicar que un grupo no está disponible un día específico, solo tiene que establecer el horario laboral de dicho día en un valor nulo: -SundayTimeRange1 $Null).

Al configurar horarios laborales en un conjunto de horarios, tenga en cuenta que cada día de la semana tiene una propiedad Hours1 y una propiedad Hours2. Si el servicio de asistencia técnica está disponible de 8:00 a. m. a 5:00 p. m., solo necesitará asignar valores a la propiedad Hours1 correspondiente. Sin embargo, supongamos que el servicio de asistencia está disponible de 8:00 a. m. a 2:00 p. m., y de 5:00 p. m. a 11:00 p. m. En este caso, deberá asignar el intervalo de horas de 8:00 a. m. a 2:00 p. m. a Hours1 y de 5:00 p. m. a 11:00 p. m. a Hours2.

Tenga en cuenta que Set-CsRgsHoursOfBusiness no modifica directamente un conjunto de horarios laborales. Es necesario usar Get-CsRgsHoursOfBusiness para crear una referencia a objeto al conjunto que se modificará. (Al crear una referencia a objeto, se recupera una copia del conjunto de horarios laborales y se almacena en una variable.) Una vez creada la referencia a objeto, se modifican las propiedades del objeto en la memoria. Después de realizar las modificaciones, se usa Set-CsRgsHoursOfBusiness para escribir los cambios en el conjunto de horarios laborales real.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsRgsHoursOfBusiness 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-CsRgsHoursOfBusiness"}

Parámetros

Parámetro Requerido Tipo Descripción

Instance

Requerido

Objeto BusinessHours

Referencia a objeto al conjunto de horarios laborales que se modificará. Para recuperar una referencia a objeto se usa el cmdlet Get-CsRgsHoursOfBusiness y se asigna el valor devuelto a una variable; por ejemplo, este comando devuelve una referencia a objeto al conjunto de horarios laborales Help Desk y almacena la referencia a objeto en una variable llamada $x:

$x = Get-CsRgsHoursOfBusiness -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

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.BusinessHours. Set-CsRgsHoursOfBusiness acepta instancias transferidas del objeto de horarios laborales de Grupo de respuesta.

Tipos de valores devueltos

Modifica instancias del objeto Microsoft.Rtc.Rgs.Management.WriteableSettings.BusinessHours.

Ejemplo

-------------------------- Ejemplo 1 ------------------------

$weekend = New-CsRgsTimeRange -Name "Weekend Hours" -OpenTime "12:00" -CloseTime "17:00"

$x = Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Business Hours"
$x.SaturdayHours1 = $weekend
$x.SundayHours1 = $weekend
Set-CsRgsHoursOfBusiness -Instance $x

El ejemplo anterior muestra cómo asignar un nuevo valor de intervalo de tiempo a las propiedades SaturdayHours1 y SundayHours1 del conjunto de horarios laborales Help Desk Business Hours. Para ello, el primer comando del ejemplo usa New-CsRgsTimeRange para crear un objeto de intervalo de tiempo (Weekend Hours) con la hora de apertura 12:00 p. m. (12:00) y la hora de cierre 5:00 p. m. (17:00). Este objeto se almacena en una variable llamada $weekend.

El siguiente comando crea una referencia a objeto ($x) al conjunto de horarios laborales Help Desk Business Hours de ApplicationServer:atl-cs-001.litwareinc.com. Una vez completado este comando, se usan los comandos 3 y 4 para establecer las propiedades SaturdayHours1 y SundayHours1 en el valor de intervalo de tiempo almacenado en $weekend. Finalmente, el último comando del ejemplo usa Set-CsRgsHoursOfBusiness para escribir los cambios en el conjunto de horarios laborales real.

-------------------------- Ejemplo 2 ------------------------

$x = Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Business Hours"
$x.SaturdayHours1 = $Null
$x.SaturdayHours2 = $Null

Set-CsRgsHoursOfBusiness -Instance $x

Los comandos del Ejemplo 2 eliminan los valores configurados para las propiedades SaturdayHours1 y SaturdayHours2 del conjunto de horarios laborales Help Desk Business Hours. Para ello, el primer comando crea una referencia a objeto ($x) al conjunto de horarios laborales Help Desk Business Hours de ApplicationServer:atl-cs-001.litwareinc.com. Una vez creada la referencia a objeto, el segundo comando establece la propiedad SaturdayHours1 en un valor nulo ($Null); de este modo se borra cualquier valor previamente asignado a SaturdayHours1. A continuación, se usa un comando similar para borrar cualquier valor asignado anteriormente a SaturdayHours2.

El último comando del ejemplo usa Set-CsRgsHoursOfBusiness para escribir los cambios en el conjunto de horarios laborales real. Cuando el comando termine de ejecutarse, no habrá ningún horario laboral correspondiente al sábado asignado a Help Desk Business Hours.