Compartir a través de

  • Artículo

Get-CsRgsHoursOfBusiness

 

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

Recupera información sobre las recopilaciones de horarios de trabajo de Grupo de Respuesta configuradas en la organización. Las recopilaciones de horarios de trabajo 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

Get-CsRgsHoursOfBusiness [-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 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.

El cmdlet Get-CsRgsHoursOfBusiness permite recuperar información sobre las recopilaciones de horarios laborales configuradas 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-CsRgsHoursOfBusiness 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-CsRgsHoursOfBusiness"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Rgs

Representa la identidad del servicio en el que se hospeda la colección de horarios laborales, o la identidad completa de la propia colección. Si especifica la identidad del servicio, por ejemplo, service:ApplicationServer:atl-cs-001.litwareinc.com, se devolverán todas las recopilaciones de horarios laborales hospedadas en dicho servicio. Si especifica la identidad de la colección, solo se devolverá la colección de horarios laborales especificada. Tenga en cuenta que la identidad de una colección de horarios laborales consiste en el valor Identity del servicio seguido de un identificador único global (GUID); por ejemplo: service:ApplicationServer-1/1987d3c2-4544-489d-bbe3-59f79f530a83.

También puede recuperar una colección de horarios laborales si especifica la identidad del servicio y, a continuación, incluye el parámetro Name y el nombre de la colección. De este modo, es posible recuperar una colección de horarios laborales sin necesidad de saber cuál es el identificador GUID asignado a la colección.

Si se llama a Get-CsRgsHoursOfBusiness sin definir ningún parámetro, se devolverán todas las recopilaciones de horarios laborales configuradas en la organización.

Name

Opcional

Cadena de caracteres

Nombre único asignado a la colección de horarios laborales al crearla.

Tipos de entrada

Ninguno. Get-CsRgsHoursOfBusiness no acepta la entrada transferida.

Tipos de valores devueltos

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

Ejemplo

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

Get-CsRgsHoursOfBusiness

En el Ejemplo 1 se devuelve información sobre todas las recopilaciones de horarios laborales configuradas para su uso en la organización. Para ello, se llama a Get-CsRgsHoursOfBusiness sin parámetros.

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

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

El comando del Ejemplo 2 devuelve todas las recopilaciones de horarios laborales configuradas para el uso en atl-cs-001.litwareinc.com.

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

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

El comando anterior devuelve una única colección de horarios laborales de atl-cs-001.litwareinc.com: la colección llamada "Help Desk Business Hours".

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

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

El comando anterior devuelve todas las recopilaciones de horarios laborales con horas laborales configuradas para los domingos. Para ello, el comando primero llama a Get-CsRgsHoursOfBusiness para devolver todas las recopilaciones de horarios laborales encontradas en atl-cs-001.litwareinc.com. A continuación, estos datos 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 y/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 periodo.

-------------------------- Ejemplo 5 ------------------------

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.MondayTimeRange1.OpenTime -le "08:00:00"}

El comando del Ejemplo 5 devuelve todas las recopilaciones de horarios laborales de atl-cs-001.litwareinc.com en las que la hora de apertura de la propiedad MondayTimeRange1 es igual a (o anterior a) 8:00 a. m.. Para ello, el comando usa primero Get-CsRgsHoursOfBusiness para devolver todas las recopilaciones de horarios laborales de atl-cs-001.litwareinc.com. Luego, estos datos se transfieren al cmdlet Where-Object, que selecciona solo aquellas recopilaciones donde el valor de la propiedad MondayTimeRange1.OpenTime es menor que o igual a 8:00 a. m. (08:00:00).

-------------------------- Ejemplo 6 ------------------------

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

El comando del Ejemplo 6 devuelve todas las recopilaciones de horarios laborales públicas, es decir, recopilaciones que pueden compartirse entre flujos de trabajo. Para ello, el comando primero usa Get-CsRgsHoursOfBusiness para devolver todas las recopilaciones de horarios laborales encontradas en atl-cs-001.litwareinc.com. A continuación, se transfieren estos datos al cmdlet Where-Object, que selecciona únicamente aquellas recopilaciones en las que la propiedad Custom es igual a False.