Automatic Australian Holiday Rulesets for Response Group Service

By | September 3, 2016

Note: A bug in v1.0 Test-CsLisIpAddress sends users to this webpage to download the update. You can find it here


Update 09/12/2017 Released Version 2.0 with a massive overhaul over the last few months to support 2018 and beyond thanks to XML support.

About the tool

This is a script that adds/maintains the relevant Australian Holidays to your Skype4B  / Lync environment for the next 12 months based on data available from the Australian Government Website.

I re-wrote most of the script from scratch and added a whole bunch of code to try and catch a lot of the errors etc that happened in the older versions. I’ve also tried to make it alot simpler to use for everyone that’s not me 🙂

Data is taken from and I have done my best to be as error free as possible.

Shout of to Greig in Sydney for beta testing and providing the red pen. That guy would have made a brilliant English teacher.



Download, and run on a Frontend or any machine with the Lync / Skype4B management tools installed

The script will attempt to detect your Skype4B Setup and proceed accordingly

  • If it only detects a single FrontEnd it will prompt you to confirm the selected pool and then configure new Holiday sets
  • Should it detect multiple pools it will ask you to confirm which pool to use and configure new Holiday sets
  • If it finds Holiday sets with the same name they will automatically have any existing entries removed

If you already have holiday sets with the name names or you need to add a country code. You can specify a string with the -RGSPrepend parameter to prepend to the Holiday set names.

Unattended (Scheduled Task) execution

You can also use the script on a scheduled task to automatically pull and update the latest holidays on a monthly basis if your server has internet access.
Simply specify -FrontEndPool <FEPoolFQDN> and -Unattended in the scheduled task.

You can also still specify the -ServiceID and -Unattended parameters at the commandline if you want to specify the ServiceID directly.
Use Get-CsRgsConfiguration -Identity to see valid service id’s

Note either of these options will disable script update checking. So it pays to check manually every now and again.

Applying the Holiday sets

After you have run the script, you can find the time frames in the Response Groups Editor, Simply tick the states you want the workflow closed for.
Note: each of the states already includes the National holiday set, so there is no need to tick both.


You can grab it from the TechNet Gallery here Download

Fork Me

As alot of my code is open source, I’ve moved from storing my Git repo on VSTS over to GitHub. Feel free to fork the code for your own purposes over here


The default holiday set names are “National”,”Victoria”,”New South Wales”,”Queensland”,”ACT”,”Northern Territory”,”South Australia”,”Western Australia”,”Tasmania”
If you need to change these for whatever reason update the following lines in the script

$National = $RGSPrepend+"National"
$Vic = $RGSPrepend+"Victoria"
$NSW = $RGSPrepend+"New South Wales"
$QLD = $RGSPrepend+"Queensland"
$ACT = $RGSPrepend+"ACT"
$NT = $RGSPrepend+"Northern Territory"
$SA = $RGSPrepend+"South Australia"
$WA = $RGSPrepend+"Western Australia"
$Tas = $RGSPrepend+"Tasmania"

Version history

Update 09/10/2017 Released Version 2.0 with a Massive Overhaul, updated for 2018!
Added Autodetecton of single RGS pool : Added Autodetecton of single RGS pool
Complete Rewrite of existing rule rewrite code , Should make for alot less red text!
More User friendly and better instructions
Fixed a few typo’s causing dates to be incorrect.
You no longer need to “Reassign” the holiday sets to response groups anymore.

Update 2/11/2016: Released Version 1.1 of the script. Fixed Onedrive download link

Fix for Typo in Victora Holiday set causing import to fail
Fix ForEach loop not correctly removing old time frames
Fix Documentation not including the SID for ServiceID parameter

Update 26/09/2016: Fixed some Typo’s. Thanks Grieg

One thought on “Automatic Australian Holiday Rulesets for Response Group Service

  1. Pingback: Announcement: New version of my Australian Response Group Holiday Rules, Now fully automatic every year! |

Leave a Reply