New-CsRgsTimeRange
Última modificación del tema: 2012-03-23
Crea un intervalo de tiempo para Grupo de respuesta. La Aplicación de grupo de respuesta usa los intervalos de tiempo para especificar la hora de apertura y de cierre de un día laboral. Por ejemplo, si los agentes del servicio de asistencia técnica sólo están disponibles de 12:00 a. m. a 5:00 p. m. los domingos, deberá crear un intervalo de tiempo para los domingos con el valor 12:00 a. m. para la hora de apertura y el valor 5:00 p. m. para la hora de cierre.
Sintaxis
New-CsRgsTimeRange -CloseTime <Nullable> -OpenTime <Nullable> [-Name <String>]
Descripción detallada
La Aplicación de grupo de respuesta usa recopilaciones de horarios laborales para controlar 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, supongamos que su servicio de asistencia técnica está disponible de 7:00 a. m. a 7:00 p. m. todos los lunes. En este caso, deberá hacer dos cosas: usar el cmdlet New-CsRgsHoursOfBusiness para crear una colección de horarios laborales para el servicio de asistencia técnica, y modificar la propiedad MondayTimeRange1 para indicar que el servicio abre a las 7:00 a. m. y cierra a las 7:00 p. m.
Para modificar una colección de horarios laborales debe usar el cmdlet Set-CsRgsHoursOfBusiness. Sin embargo, no puede usar dicho cmdlet para modificar directamente una propiedad de intervalo de tiempo; por ejemplo, Set-CsRgsHoursOfBusiness no tiene ningún parámetro que se corresponda con la propiedad MondayTimeRange1. Para modificar una colección de horarios laborales es necesario recuperar la colección usando Get-CsRgsHoursOfBusiness, realizar los cambios en la colección en la memoria y, a continuación, usar Set-CsRgsHoursOfBusiness para escribir dichos cambios en la colección de horarios laborales real.
En la mayoría de los casos, los cambios realizados en una colección de horarios laborales implican cambiar la hora de apertura/cierre de un día o días específicos. Para modificar las horas de apertura y cierre debe especificar dichas horas con el cmdlet New-CsRgsTimeRange. Al llamar a este cmdlet, el valor resultante debe almacenarse en una variable de referencia a objeto. Esta variable se usará para establecer las horas de apertura y cierre en la colección de horarios laborales.
También debe usar New-CsRgsTimeRange para especificar las horas de apertura y cierre siempre que cree una colección de horarios laborales.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsRgsTimeRange de forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Sin embargo, dado que este cmdlet crea un objeto en memoria y, por sí mismo, no hace ningún cambio en el sistema, básicamente puede ejecutarlo cualquiera. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde el símbolo del sistema Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsTimeRange"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
CloseTime |
Requerido |
TimeSpan |
Hora del día en que termina el horario laboral. El parámetro CloseTime debe tener formato de 24 horas; por ejemplo, para indicar que el horario laboral termina a las 9:00 p. m., debe usar este formato: -CloseTime "21:00". |
OpenTime |
Requerido |
TimeSpan |
Hora del día en que comienza el horario laboral. El parámetro OpenTime debe tener formato de 24 horas; por ejemplo, para indicar que el horario laboral comienza a la 1:30 p. m., debe usar este formato: -OpenTime "13:30". |
Name |
Opcional |
Cadena de caracteres |
Identificador único del intervalo de horas que se creará. El nombre puede tener un máximo de 128 caracteres. |
Tipos de entrada
Ninguno. New-CsRgsTimeRange no acepta la entrada transferida.
Tipos de valores devueltos
New-CsRgsTimeRange crea instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.TimeRange.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
$sundayHours = New-CsRgsTimeRange -Name "Sunday hours" -OpenTime "08:30" -CloseTime "13:30"
$y = Get-CsRgsHoursOfBusiness -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Hours"
$y.SundayHours1 = $sundayHours
Set-CsRgsHoursOfBusiness -Instance $y
El ejemplo anterior muestra cómo usar el cmdlet New-CsRgsTimeRange para modificar las propiedades de un conjunto de horarios laborales. En este ejemplo, primero se llama a New-CsRgsTimeRange para crear un intervalo de horas llamado "Sunday hours". Este intervalo establece la hora de apertura a las 8:30 a. m. (08:30) y la hora de cierre a la 1:30 p. m. (13:30). El intervalo de horas en memoria creado por este comando se almacena en una variable llamada $sundayHours.
Una vez configurado el intervalo de tiempo, el segundo comando del ejemplo usa el cmdlet Get-CsRgsHoursOfBusiness para devolver la colección de horarios laborales llamada Help Desk Hours (del servicio ApplicationServer:atl-cs-001.litwareinc.com). La colección devuelta se almacena en una variable llamada $y.
Una vez recuperada la colección, el comando 3 establece el valor de la propiedad SundayHours1 en $sundayHours, la referencia a objeto que contiene el intervalo de horas recién creado. Una vez completado el comando, se usa Set-CsRgsHoursOfBusiness para escribir los cambios en la colección de horarios laborales Help Desk Hours. Tenga en cuenta que si no llama a Set-CsRgsHoursOfBusiness, el intervalo de horas creado solo existirá en la memoria y desaparecerá al cerrar Windows PowerShell o eliminar la variable $sundayHours. En este caso, la colección de horarios laborales Help Desk Hours no se actualizará.
-------------------------- Ejemplo 2 ------------------------
$sundayHours = New-CsRgsTimeRange -Name "Sunday hours" -OpenTime "08:30" -CloseTime "13:30"
New-CsRgsHoursOfBusiness -Parent Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Hours" -SundayHours1 $sundayHours
En el Ejemplo 2 se muestra cómo crear un intervalo de horas de Grupo de respuesta y usarlo en un nuevo conjunto de horarios laborales. El primer comando del ejemplo usa el cmdlet New-CsRgsTimeRange para crear un intervalo de horas llamado Sunday Hours. El parámetro OpenTime del intervalo se establece a las 8:30 a. m. ("08:30") y CloseTime, a la 1:30 p. m. ("13:30", que equivales a 13 horas y 30 minutos en formato de 24 horas). El objeto de intervalo de horas resultante se almacena en una variable llamada $sundayHours.
En el segundo comando, se usa el cmdlet New-CsRgsBusinessHours para crear una colección de horarios laborales llamada Help Desk Hours. En este comando, la variable $sundayHours determina el intervalo de horas de la propiedad SundayHours1.