Compartir a través de

  • Artículo

Remove-CsRgsHoursOfBusiness

 

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

Quita un conjunto de horarios laborales de Grupo de respuesta. Los horarios laborales se usan para indicar los días de la semana y las horas del día en que los agentes de Grupo de respuesta están disponibles para responder a llamadas.

Sintaxis

Remove-CsRgsHoursOfBusiness -Instance <BusinessHours> [-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.

Los horarios laborales se crean con el cmdlet New-CsRgsHoursOfBusiness y pueden quitarse más adelante usando Remove-CsRgsHoursOfBusiness. Tenga en cuenta que al llamar a Remove-CsRgsHoursOfBusiness, se quita el conjunto completo de horarios y ya no podrá volver a usarse. Si solo quiere quitar el horario laboral de un día específico (por ejemplo, porque el servicio de asistencia técnica ya no estará disponible los domingos), use Set-CsRgsHoursOfBusiness para quitar solo los valores correspondientes de una colección.

De manera predeterminada, Remove-CsRgsHoursOfBusiness muestra un mensaje de advertencia al intentar eliminar un horario laboral que use actualmente un flujo de trabajo activo. El usuario debe verificar que desea quitar la colección y no se realizará ninguna acción hasta que lo haga. Para anular la advertencia y eliminar los conjuntos de horarios laborales sin verificación, incluso si están asignados a un flujo de trabajo activo, debe usarse el parámetro Force. Por ejemplo:

Get-CsRgsHoursOfBusiness –Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Remove-CsRgsHoursOfBusiness –Force

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Remove-CsRgsHoursOfBusiness 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-CsRgsHoursOfBusiness"}

Parámetros

Parámetro Requerido Tipo Descripción

Instance

Requerido

Objeto de horario laboral

Referencia a objeto que apunta al conjunto de horario laboral que se eliminará. Al transferir objetos de flujo de trabajo a Remove-CsRgsHoursOfBusiness se puede dejar en blanco el parámetro Instance.

Para usar el parámetro Instance, use comandos similares a lo siguiente:

$x = Get-CsRgsHoursOfBusiness –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83

Remove-CsRgsHoursOfBusiness –Instance $x

Tenga en cuenta que solo puede eliminar un único conjunto de horario laboral cada vez al usar el parámetro de Instance. Es decir, la referencia a objeto ($x) no puede contener varios objetos de horario laboral.

Force

Opcional

Parámetro modificador

Fuerza la eliminación de un conjunto de horarios laborales. Si el parámetro está presente, el conjunto se eliminará sin mostrar ningún mensaje de advertencia, incluso si está asignado a un flujo de trabajo activo. Si el parámetro no está presente, se le pedirá confirmación para eliminar cualquier conjunto de horarios laborales 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

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Rgs.Management.WritableSettings.BusinessHours. Remove-CsRgsHoursOfBusiness acepta instancias transferidas del objeto de horarios laborales de Grupo de respuesta.

Tipos de valores devueltos

Devuelve instancias existentes del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.BusinessHours.

Ejemplo

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

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Remove-CsRgsHoursOfBusiness

El comando del Ejemplo 1 quita todos los conjuntos de horarios laborales del servicio ApplicationServer:atl-cs-001.litwareinc.com. Para ello, el comando primero llama a Get-CsRgsHoursOfBusiness para devolver todos los conjuntos de horarios laborales del servicio ApplicationServer:atl-cs-001.litwareinc.com. A continuación, estos conjuntos se transfieren al cmdlet Remove-CsRgsHoursOfBusiness, que los elimina todos.

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

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Business Hours" | Remove-CsRgsHoursOfBusiness

En el Ejemplo 2 se quita un único conjunto de horarios laborales de ApplicationServer:atl-cs-001.litwareinc.com: el conjunto llamado Help Desk Business Hours.

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

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.SundayTimeRange1 -ne $Null -or $_.SundayTimeRange2 -ne $Null} | Remove-CsRgsHoursOfBusiness

El comando anterior elimina todos los conjuntos de horarios laborales con horas laborales configuradas para los domingos. Para ello, el comando primero llama a Get-CsRgsHoursOfBusiness para devolver todos los conjuntos de horarios laborales de ApplicationServer:atl-cs-001.litwareinc.com. A continuación, estos conjuntos se transfieren al cmdlet Where-Object, que selecciona solo los elementos en los que se cumple uno de los siguientes criterios: la propiedad SundayTimeRange1 no es igual a un valor nulo o la propiedad SundayTimeRange2 no es igual a un valor nulo. (Si la propiedad de intervalo de tiempo no es nula, se han configurado horarios laborales para dicho intervalo.) Cualquier conjunto que cumpla al menos uno de estos criterios se transfiere al cmdlet Remove-CsRgsHoursOfBusiness, que quita dicho conjunto.

-------------------------- Ejemplo 4 ------------------------

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.Custom -eq $True} | Remove-CsRgsHoursOfBusiness -Force

El comando del Ejemplo 4 elimina todos los conjuntos de horarios laborales personalizados, es decir, conjuntos que no pueden compartirse entre flujos de trabajo. Para ello, el comando primero usa Get-CsRgsHoursOfBusiness para devolver todos los conjuntos de horarios laborales de ApplicationServer:atl-cs-001.litwareinc.com. A continuación, se transfieren estos datos al cmdlet Where-Object, que selecciona únicamente aquellos conjuntos en los que la propiedad Custom es igual a True. A continuación, estos conjuntos se transfieren a Remove-CsRgsHoursOfBusiness, que los elimina.