[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Creates a new Response Group holiday set. A Response Group holiday set is a collection of holidays. For example, you might have one holiday set for a US-based queue (a set which might include a holiday for the Fourth of July) and a different set for a queue based in France. The latter queue might define a holiday for Bastille Day but not for the Fourth of July.

Syntax

New-CsRgsHolidaySet -Parent <RgsIdentity> -Holidays <Collection> -Name <String> [-InMemory <SwitchParameter>] [-Tenant <Nullable>]

Parameters

Parameter Required Type Description

Parent

Required

Rgs Identity

Service where the new holiday set will be hosted. For example: -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com".

Name

Required

String

Unique name to be assigned to the holiday set. The combination of the Parent property and the Name property enables you to uniquely identify holiday sets without having to refer to the set’s GUID (globally unique identifier).

Holidays

Required

Holiday object collection

One or more holidays to be added to the holiday set. Holidays must be created using the New-CsRgsHoliday cmdlet and then stored in an object reference. These object references are then passed to the –Holidays parameter in order to add the holidays to the holiday set. For example, this command creates a holiday named New Year’s Day and then stores the resulting value in an object reference named $x:

$x = New-CsRgsHoliday -StartDate "1/1/2011" -EndDate "1/1/2011" -Name "New Year's Day"

InMemory

Optional

Switch Parameter

Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet’s matching Set- cmdlet.

Force

Optional

Switch Parameter

Suppresses the display of any non-fatal error message that might arise when running the command.

Detailed Description

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 AM to 5:00 PM Monday through Friday then you would configure business hours that show that agents are available from 9:00 AM to 5:00 PM Monday through Friday (and, by extension, that agents are not available at, say, 8:00 PM on a Thursday or 2:30 PM on a Sunday).

Of course, in many organizations there are exceptions to the typical work week; for example, in the US 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 US might collected in a holiday set named US_Holidays, while holidays for Japan might be collected in a holiday set named Japanese_Holidays. Once collected, 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. In turn, these individual holidays must be created using the New-CsRgsHoliday cmdlet.

Return Types

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

Examples

-------------------------- 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" -Holidays($x)

The commands shown in Example 1 create a new holiday set named 2011 Holidays and assigns this holiday set a new holiday (New Year’s Day). In order to carry out this task, 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 AM); -EndDate, which represents the end date for the holiday (1/2/2011 12:00 AM); 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 (-Holidays ($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 -Holidays: -Holidays($x, $y, $z).