Compartir a través de

  • Artículo

Set-CsRgsHolidaySet

 

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

Modifica los valores de propiedad de un conjunto de días festivos de Grupo de respuesta. Un conjunto de días festivos de Grupo de respuesta es una colección de festivos. Por ejemplo, puede tener un conjunto de días festivos para una cola de Estados Unidos (EE.UU.) (conjunto que puede incluir un día festivo el 4 de julio) y otro conjunto para una cola de Francia. La segunda cola puede incluir un festivo el día de la Fiesta Nacional Francesa, pero no el 4 de julio.

Sintaxis

Set-CsRgsHolidaySet -Instance <HolidaySet> [-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 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.

Sin embargo, en muchas organizaciones habrá excepciones que se apliquen a la semana laboral; por ejemplo, en Estados Unidos puede haber organizaciones que cierren el día de Navidad o Acción de Gracias. Para que estos días de cierre se vean reflejados, la Aplicación de grupo de respuesta permite designar determinados días como festivos: días en los que la organización estaría abierta normalmente pero, por cualquier motivo, no lo está. Los días festivos individuales (creados con el cmdlet New-CsRgsHoliday) se recopilan en conjuntos de días festivos. Por ejemplo, los días festivos de Estados Unidos pueden recopilarse en un conjunto de días festivos llamado US_Holidays, mientras que los festivos de Japón pueden recopilarse en un conjunto llamado Japanese_Holidays. Después de ser recopilados, los conjuntos de días festivos pueden asignarse a flujos de trabajo de Grupo de respuesta.

El cmdlet Set-CsRgsHolidaySet permite modificar un conjunto de días festivos. (En la mayoría de los casos, la modificación consiste en agregar o quitar festivos del conjunto.) Set-CsRgsHolidaySet no se usa para realizar cambios directamente en un conjunto de días festivos. Este cmdlet Get-CsRgsHolidaySet crea una referencia a objeto a un conjunto de días festivos existente. (Una referencia a objeto es una variable que, en este caso, hace referencia a un conjunto de días festivos existente). Los cambios se aplican al conjunto en la memoria y, a continuación, se usa Set-CsRgsHolidaySet para escribir dichos cambios en el conjunto de días festivos real. Si no llama a Set-CsRgsHolidaySet, los cambios solo se aplicarán en la memoria, y desaparecerán al cerrar Windows PowerShell o eliminar la 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-CsRgsHolidaySet 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 (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsRgsHolidaySet"}

Parámetros

Parámetro Requerido Tipo Descripción

Instance

Requerido

Objeto HolidaySet

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

$x = Get-CsRgsHolidaySet -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.HolidaySet. Remove-CsRgsHolidaySet acepta instancias transferidas del objeto del conjunto de días festivos de Grupo de respuesta.

Tipos de valores devueltos

Set-CsRgsHolidaySet no devuelve objetos ni valores. Este cmdlet se usa para modificar instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet.

Ejemplo

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

$x = New-CsRgsHoliday -StartDate "12/25/2010" -EndDate "12/26/2010" -Name "Christmas Day"
$y = Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"
$y.HolidayList.Add($x)
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 (un festivo "virtual" que solo existe en la memoria y se almacena en la variable $x). New-CsRgsHoliday usa tres parámetros: StartDate, que representa la fecha de inicio del festivo (12/25/2010); EndDate, que representa la fecha de finalización del festivo (12/26/2010); y Name, que representa el nombre único que se asigna al 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 ($x) a la copia virtual del conjunto de días festivos ($y). El último comando usa Set-CsRgsHolidaySet para escribir los cambios y agregar el nuevo festivo al servicio ApplicationServer:atl-cs-001.litwareinc.com.

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

$x = Get-CsRgsHolidaySet -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "2010 Holidays"
$y = $x.HolidayList | Where-Object {$_.Name -eq "Christmas Day"}
$x.HolidayList.Remove($y)
Set-CsRgsHolidaySet -Instance $x

El comando del Ejemplo 2 quita un festivo, en este caso, el Christmas Day, de un conjunto de festivos. Para ello, el primer comando del ejemplo usa Get-CsRgsHolidaySet para recuperar el conjunto de días festivos del año 2010 (-Name "2010 Holidays") del servicio ApplicationServer:atl-cs-001.litwareinc.com. Los datos recuperados se almacenan en una variable llamada $x.

En el segundo comando, la propiedad HolidayList del conjunto de días festivos recuperado se transfiere al cmdlet Where-Object, que selecciona el festivo cuya propiedad Name es igual a "Christmas Day". Este día festivo se almacena en la variable $y.

Una vez recuperado el festivo Christmas Day, el comando 3 usa el método Remove para quitar dicho festivo ($y) del conjunto de festivos ($x). El último comando del ejemplo usa Set-CsRgsHolidaySet para escribir los cambios (quitando el festivo Christmas Day) en el conjunto de días festivos 2010 Holidays de ApplicationServer:atl-cs-001.litwareinc.com.

-------------------------- Ejemplo 3 ------------------------

$x = Get-CsRgsHolidaySet -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "2010 Holidays"
$x.HolidayList.Clear()
Set-CsRgsHolidaySet -Instance $x

Los comandos del Ejemplo 3 eliminan todos los días festivos del conjunto "2010 Holidays" del servicio ApplicationServer:atl-cs-001.litwareinc.com. Para ello, el primer comando del ejemplo usa Get-CsRgsHolidaySet para recuperar el conjunto de días festivos correspondiente de ApplicationServer:atl-cs-001.litwareinc.com. Dicho conjunto se almacenan en una variable llamada $x.

Una vez recuperado el conjunto de festivos, se usa el método Clear para quitar todos los valores almacenados en la propiedad HolidayList. Una vez borrada esta propiedad, el comando final del ejemplo usa el cmdlet Set-CsRgsHolidaySet para escribir los cambios en el conjunto de días festivos 2010 Holidays.