Anywhere365: How to manage the Business Hours of a UCC’s with REST, JSON and PowerShell part #1

Title

How to manage the Business Hours of multiple UCC’s with REST, JSON and PowerShell, part #1

(Business) Goal

In Anywhere365 you have the concept of Business Hours for individual Unified Contact Centers. Every contact center has a list in SharePoint where these hours are defined. When you have enough permissions you can edit this very easily.

When you are interested in more details about the concept of Business Hours in Anywhere365 Core I can recommend the Business Hours Explained article on Go Live, which includes a training video.

Recently I was asked to update the Business Hours of multiple Unified Contact Centers. Since I didn’t want to open every single list and edit these via the interface I decided to find a way to automate this. In this first part I want to show you the basics of getting the business hours of a single UCC with REST, JSON and PowerShell

Technical Overview

This article describes how to use JSON to manage your Business Hours. This article is based on the Tips and Tricks – SharePoint article on GoLive documentation of Workstreampeople. In addition to the examples I am throwing PowerShell in the mix.

This script uses the Invoke-RestMethod cmdlet, a cmdlet which can be used to send an HTTP or HTTPS request to a RESTful web service. This cmdlet was introduced in Windows PowerShell 3.0. Like in the Go Live article I used on of my favourite tools to design the requests, Fiddler.

But during the first few tries with the Invoke-RestMethod I came accross an error:
Invoke-RestMethod : The ‘accept’header must be modified using the appropriate property or method.

After some research I found the following description of a Invoke-RestMethod Accept header bug in PowerShell on Microsoft Connect.

Currently the script is far from perfect, so I am only sharing this for inspiration and I would definitely first test it on a testing environment!

Prerequisites

To complete this how-to, you must have the following prerequisites must be met:
– Member of Local Administrators group on the Anywhere365 Application server
– Member of Local Administrators group on every server with Lync Server file shares
– Member of the CSAdministrator group in the domain
– Member of the RTCUniversalServerAdmins group in the domain

Steps

1. Adjust the hard coded path values matching your environment
2. Run the Powershell script in Windows PowerShell via the following command .\get_businesshours_ucc.ps1

Get Business Hours

Additional resources

Invoke-RestMethod Accept header
TechNet – Invoke-RestMethod cmdlet
Workstreampeople – Business Hours Explained
Workstreampeople – Tips and Tricks – SharePoint

Applies to

Anywhere 365, Skype for Business 2016, SharePoint 2013

Change History

28-04-2017 – 1.0

You may also like...

Leave a Reply

Your email address will not be published. Required fields are marked *