Parameters

In order to provide callers with the best possible experience, the Response Group application makes it possible for you to clearly define when Response Group agents are available to answer calls and when they are not available to answer calls. With the Response Group application, you can define business hours; these business hours indicate the days of the week and hours of the day that agents are available to answer calls. For example, if your organization is typically open from 9:00 A.M. to 5:00 P.M. Monday through Friday then you would configure business hours that show that agents are available from 9:00 A.M. to 5:00 P.M. Monday through Friday (and, by extension, that agents are not available at, say, 8:00 P.M. on a Thursday or 2:30 P.M. on a Sunday).

However, in many organizations there are exceptions to the typical work week; for example, in the U.S. an organization might be closed on Christmas Day or Thanksgiving Day. In order to accommodate for atypical closures, the Response Group application enables you to designate certain days as holidays: days when the organization would usually be open but, for whatever reason, is not. Individual holidays (created using the New-CsRgsHoliday cmdlet) are collected in holiday sets; for example, holidays for the U.S. might be collected in a holiday set named US_Holidays, while holidays for Japan might be collected in a holiday set named Japanese_Holidays. After they are collected, holidays and their corresponding holiday sets can then be assigned to Response Group workflows.

The New-CsRgsHolidaySet cmdlet provides a way for you to configure new holiday sets for use in your organization. Note that, when you create a new holiday set, you must include at least one holiday; these individual holidays must be created by using the New-CsRgsHoliday cmdlet.

Who can run this cmdlet: By default, members of the following groups are authorized to run the New-CsRgsHolidaySet cmdlet locally: RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

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

None. New-CsRgsHolidaySet does not accept pipelined input.

New-CsRgsHolidaySet creates new instances of the Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet object.

-------------------------- Example 1 ------------------------

	Copy Code
$x = New-CsRgsHoliday -StartDate "1/1/2011 12:00 AM" -EndDate "1/2/2011 12:00 AM" -Name "New Year's Day" New-CsRgsHolidaySet -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2011 Holidays" -HolidayList($x)

The commands shown in Example 1 create a new holiday set named 2011 Holidays and then assign this holiday set a new holiday (New Year’s Day). In order to do this, the first command uses New-CsRgsHoliday to create a holiday for New Year’s Day. New-CsRgsHoliday takes three parameters: StartDate, which indicates the starting date for the holiday (1/1/2011 12:00 A.M.); EndDate, which represents the end date for the holiday (1/2/2011 12:00 A.M.); and Name, used to store the name assigned to the holiday. The resulting holiday object is stored in the variable $x.

After the new holiday has been created in memory, New-CsRgsHolidaySet is employed to create a new holiday set on the service ApplicationServer:atl-cs-001.litwareinc.com. This holiday set is given the name 2011 Holidays (-Name "2011 Holidays") and is assigned the holiday stored in the variable $x: -HolidayList ($x). If you want to assign multiple holidays to the holiday set simply create the new holidays, assigning each to a unique variable. You can then include all those variable names as the parameter value passed to HolidayList:

-HolidayList($x, $y, $z)

Other Resources