New-CsRgsHoliday
Última modificación del tema: 2012-03-23
Crea un festivo para Grupo de respuesta. En la Aplicación de grupo de respuesta, un festivo es un día en el que los agentes asignados a una cola, que normalmente trabajarían ese día, no trabajarán y no podrán responder a llamadas. Por ejemplo, si los trabajadores de Estados Unidos tienen vacaciones el día de Acción de Gracias, debe definirse un día festivo el 24 de noviembre de 2011.
Sintaxis
New-CsRgsHoliday -EndDate <Nullable> -StartDate <Nullable> [-Name <String>]
Descripción detallada
La Aplicación de grupo de respuesta usa la colección de horarios de trabajo para indicar 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, debe crear una colección de horarios de trabajo para el servicio de asistencia técnica y configurar la hora de apertura a las 7:00 a. m. y la hora de cierre a las 7:00 p. m. para el lunes.
Aunque puede haber excepciones a la regla de apertura de 7:00 a. m. a 7:00 p. m. los lunes. Por ejemplo, el 4 de julio es un día festivo en Estados Unidos; por lo tanto, es posible que el personal del servicio de asistencia no esté disponible dicho día. Para especificar que el servicio de asistencia no estará disponible el lunes 4 de julio de 2011, debe crear un festivo para esa fecha y agregarlo al conjunto de días festivos del servicio de asistencia.
Para crear un festivo, debe usar el cmdlet New-CsRgsHoliday. (No es necesario que haya alguna celebración o fiesta para definir un día festivo, se trata sencillamente de un día en que los agentes no estarán disponibles para responder al teléfono.) New-CsRgsHoliday no agrega directamente un festivo a un conjunto de días festivos. El cmdlet crea un festivo que sólo existe en la memoria. Por ello es necesario crear una referencia a objeto (como $x) que haga referencia a la instancia de la memoria. Cuando se ha creado el festivo en la memoria, se usa el cmdlet Get-CsRgsHolidaySet para recuperar el conjunto de días festivos correspondiente y Set-CsRgsHolidaySet para agregar el nuevo día festivo al conjunto.
Aunque los conjuntos de días festivos pueden contener (y, normalmente, contienen) varios festivos, deben agregarse al conjunto de uno en uno.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsRgsHoliday 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 Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsHoliday\b"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Name |
Requerido |
Cadena de caracteres |
Nombre único que se usa para diferenciar el festivo de otros festivos. |
EndDate |
Requerido |
DateTime |
Fecha de finalización del festivo. El formato de la fecha de finalización depende de la configuración regional y de idioma. Por ejemplo, la fecha de finalización del 4 de julio de 2011 en Estados Unidos tendría este formato: -EndDate "7/5/2011 12:00 AM", lo que indica que el día festivo finaliza a las 12:00 a. m. el 5 de julio de 2011. |
StartDate |
Requerido |
DateTime |
Fecha de inicio del festivo. El formato de la fecha de inicio depende de la configuración regional y de idioma. Por ejemplo, la fecha de inicio del 4 de julio de 2011 en Estados Unidos tendría este formato: -StartDate "7/4/2011 12:00 AM", lo que indica que el día festivo comienza a las 12:00 a. m. el 4 de julio de 2011. |
Tipos de entrada
Ninguno. New-CsRgsHoliday no acepta la entrada transferida.
Tipos de valores devueltos
New-CsRgsHoliday crea instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Holiday.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
$christmasDay = New-CsRgsHoliday -StartDate "12/25/2010 12:00 AM" -EndDate "12/26/2010 12:00 AM" -Name "Christmas Day"
$y = Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"
$y.HolidayList.Add($christmasDay)
Set-CsRgsHolidaySet -Instance $y
En el comando del Ejemplo 1 se crea un festivo (Christmas Day) y se asigna a un conjunto de días festivos existente. Para ello, el primer comando del ejemplo usa el cmdlet New-CsRgsHoliday para crear un festivo "virtual" que solo existe en la memoria y se almacena en la variable $christmasDay. New-CsRgsHoliday usa tres parámetros: StartDate, que representa la fecha de inicio del festivo (12/25/2010 12:00 AM); EndDate, que representa la fecha de finalización del festivo (12/26/2010 12:00 AM); y Name, que representa el nombre único que identifica el festivo.
Después de crear el festivo, el segundo comando usa Get-CsRgsHolidaySet para recuperar el conjunto de días festivos "2010 Holidays" del servicio ApplicationServer:atl-cs-001.litwareinc.com. Este conjunto de días festivos se almacena en la variable $y.
El comando 3 usa el método Add para agregar el nuevo festivo ($christmasDay) a la copia virtual del conjunto de días festivos ($y). El último comando llama a Set-CsRgsHolidaySet para escribir los cambios, es decir, para agregar el nuevo festivo, al servicio ApplicationServer:atl-cs-001.litwareinc.com.