Remove-CsRgsHolidaySet
Última modificación del tema: 2012-03-23
Quita 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
Remove-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. Una vez recopilados, los días festivos y los conjuntos de días festivos pueden asignarse a flujos de trabajo de Grupo de respuesta.
El cmdlet Remove-CsRgsHolidaySet permite a los administradores quitar conjuntos de días festivos de Grupo de respuesta. De manera predeterminada, si intenta quitar un conjunto de días festivos asignado a un flujo de trabajo activo, el cmdlet se pausará y le preguntará si está seguro de que quiere eliminar el flujo de trabajo. El comando no continuará y el conjunto de días festivos no se quitará hasta que haya confirmado que desea continuar. Para anular este mensaje de aviso y quitar un conjunto de días festivos incluso si está en uso en un flujo de trabajo activo, agregue el parámetro Force:
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays" | Remove-CsRgsHolidaySet –Force
Tenga en cuenta que al llamar a Remove-CsRgsHolidaySet, se quita el conjunto completo de festivos y ya no podrá volver a usarse. Si solo quiere quitar un único festivo de un conjunto de días festivos (por ejemplo, porque la compañía permanecerá abierta el día de Acción de gracias), use Set-CsRgsHolidaySet para quitar solamente el día festivo especificado.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Remove-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 "Remove-CsRgsHolidaySet"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Instance |
Requerido |
Objeto de conjunto de días festivos |
Referencia a objeto que apunta al conjunto de días festivos que se eliminará. Al transferir objetos de flujo de trabajo a Remove-CsRgsHolidaySet se puede dejar en blanco el parámetro Instance. Para usar el parámetro Instance, use comandos similares a lo siguiente: $x = Get-CsRgsHolidaySet –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsHolidaySet –Instance $x Tenga en cuenta que solo puede eliminar un único conjunto de días festivos cada vez al usar el parámetro de Instance. Es decir, la referencia a objeto ($x) no puede contener varios objetos de conjunto de días festivos. |
Force |
Opcional |
Parámetro modificador |
Fuerza la eliminación del conjunto de días festivos. Si el parámetro está presente, el conjunto de días festivos se eliminará sin mostrar ningún mensaje de advertencia, incluso si un flujo de trabajo activo lo está usando. Si el parámetro no está presente, se le pedirá confirmación para eliminar cualquier conjunto de días festivos asignado a un flujo de trabajo activo. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Este parámetro sólo es para realizar pruebas. |
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
Remove-CsRgsHolidaySet elimina instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays" | Remove-CsRgsHolidaySet
El comando del Ejemplo 1 quita el conjunto de días festivos "2010 Holidays" del servicio ApplicationServer:atl-cs-001.litwareinc.com. Para ello, el comando llama primero a Get-CsRgsHolidaySet con dos parámetros: el parámetro Identity (que especifica la ubicación del conjunto de días festivos); y el parámetro Name (que especifica el nombre del conjunto). El objeto devuelto se transfiere a Remove-CsRgsHolidaySet, que elimina el conjunto de días festivos 2010 Holidays.
-------------------------- Ejemplo 2 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Select-Object Identity -ExpandProperty HolidayList | Where-Object {$_.Name -eq "New Year's Day"} | Remove-CsRgsHolidaySet
El comando anterior elimina todos los conjuntos de días festivos del servicio ApplicationServer:atl-cs-001.litwareinc.com que incluyan el día festivo New Year’s Day. Para ello, el comando primero usa Get-CsRgsHolidaySet para devolver una colección de todos los conjuntos de días festivos del servicio ApplicationServer:atl-cs-001.litwareinc.com. A continuación, esta colección se transfiere al cmdlet Select-Object, que lleva a cabo dos operaciones: 1) selecciona la propiedad Identity de cada conjunto de días festivos y 2) "expande" el valor de la propiedad HolidayList. (Al expandir un valor se devuelven las propiedades del objeto subyacente. En el caso de un festivo, son propiedades como Name, StartDate y EndDate). La información seleccionada (la identidad del conjunto de días festivos y los valores de propiedad del festivo) se transfiere al cmdlet Where-Object, que selecciona los conjuntos que incluyan un festivo en el que el valor Name sea igual a (-eq) "New Year’s Day". A continuación, la colección filtrada de conjuntos de festivos se transfiere a Remove-CsRgsHolidaySet, que elimina los conjuntos de festivos que incluyan un festivo llamado New Year’s Day.
-------------------------- Ejemplo 3 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.HolidayList.Count -lt 5} | Remove-CsRgsHolidaySet
El comando del Ejemplo 3 elimina cualquier conjunto de días festivos del servicio ApplicationServer:atl-cs-001.litwareinc.com que tenga menos de 5 días festivos asignados. 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 al cmdlet Where-Object, que selecciona solo los conjuntos de festivos en los que el número de festivos asignado ($_.HolidayList.Count) es menor que 5. Estos conjuntos de festivos se transfieren al cmdlet Remove-CsRgsHolidaySet, que los elimina.