Get-CsRgsHolidaySet
Última modificación del tema: 2012-03-23
Devuelve información sobre los conjuntos de festivos de Grupo de respuesta configurados en la organización. 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
Get-CsRgsHolidaySet [-Identity <RgsIdentity>] [-Name <String>]
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.
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 Get-CsRgsHolidaySet permite recuperar información sobre los conjuntos de fías festivos de Grupo de respuesta configurados en la organización.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsRgsHolidaySet de forma local: RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsRgsHolidaySet"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Rgs |
Representa la identidad del servicio en el que se hospeda el conjunto de días festivos o la identidad completa del propio conjunto de días festivos. Si especifica la identidad del servicio, por ejemplo, service:ApplicationServer:atl-cs-001.litwareinc.com, se devolverán todos los conjuntos de días festivos hospedados en dicho servicio. Si especifica la identidad del conjunto de días festivos, solo se devolverá el conjunto especificado. Tenga en cuenta que la identidad de un conjunto de días festivos consiste en el valor Identity del servicio seguido de un identificador único global (GUID); por ejemplo: service:ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83. También puede recuperar un único conjunto de días festivos si especifica la identidad del servicio y, a continuación, incluye el parámetro Name y el nombre del conjunto. De este modo, es posible recuperar un conjunto de festivos específico sin necesidad de saber cuál es el identificador GUID que tiene asignado. Si se llama a Get-CsRgsHolidaySet sin definir ningún parámetro, se devolverá una colección de todos los conjuntos de días festivos configurados en la organización. |
Name |
Opcional |
Cadena de caracteres |
Nombre único asignado al conjunto de festivos al crearlo. |
Tipos de entrada
Ninguno. Get-CsRgsHolidaySet no acepta la entrada transferida.
Tipos de valores devueltos
Get-CsRgsHolidaySet devuelve instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsRgsHolidaySet
El comando anterior devuelve información acerca de todos los conjuntos de días festivos configurados en la organización.
-------------------------- Ejemplo 2 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"
El comando del Ejemplo 2 devuelve información sobre todos los conjuntos de festivos configurados en servicio ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Ejemplo 3 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"
En el Ejemplo 3, se devuelve un único conjunto de festivos del servicio ApplicationServer:atl-cs-001.litwareinc.com: el conjunto llamado "2010 Holidays". Los nombres de cada servicio deben ser únicos, por lo tanto, este comando nunca devolverá más de un elemento.
-------------------------- Ejemplo 4 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"| Select-Object -ExpandProperty HolidayList
El Ejemplo 4 muestra información detallada sobre los festivos del conjunto "2010 Holidays" (del servicio ApplicationServer:atl-cs-001.litwareinc.com). Para ello, el comando primero usa Get-CsRgsHolidaySet para recuperar el conjunto de días festivos especificado. A continuación, este conjunto se envía al cmdlet Select-Object, que usa el parámetro ExpandProperty para mostrar información detallada de cada festivo del conjunto.
-------------------------- Ejemplo 5 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Select-Object Identity -ExpandProperty HolidayList | Where-Object {$_.Name -eq "Christmas Day"} | ForEach-Object {Get-CsRgsHolidaySet -Identity $_.Identity}
El comando del Ejemplo 5 devuelve la identidad de todos los conjuntos de días festivos de ApplicationServer:atl-cs-001.litwareinc.com que incluyan un día festivo llamado Christmas Day. Para ello, el comando primero llama a Get-CsRgsHolidaySet para devolver una colección de todos los conjuntos de festivos de ApplicationServer:atl-cs-001.litwareinc.com. A continuación, esta colección se transfiere a Select-Object, que lleva a cabo dos operaciones: selecciona la propiedad Identity y expande la propiedad HolidayList.
Estos dos datos (la propiedad Identity y el valor expandido de la propiedad HolidayList) se transfieren al cmdlet Where-Object, Where-Objectque selecciona solo los elementos en los que el nombre del festivo es igual a Christmas Day. Finalmente, la colección filtrada se transfiere al cmdlet ForEach-Object. Este cmdlet usa Get-CsRgsHolidaySet para recuperar el conjunto de días festivos de cada una de las identidades de la colección. El resultado es una lista de todos los conjuntos de festivos que incluyen un día festivo llamado Christmas Day.