Enterprise Voice Setup Script for Lync 2013

By -
I created this script as the need to set up the same rules (as a whole) exist in many of the projects I work on.
These rules can obviously be changed but should form the basis for your own personalised script. I have put in as many comments as I think are needed so it should guide you well.

These are specifically for Ireland as we use a different format for some numbers. For example freephone numbers in most countries are 0800 but in Ireland it is 1800 which means normalising this is not an easy task!

The script below assumes calls are being sent to a PSTN Gateway via a SIP trunk.

Martin
#################
#         #
#    BEFORE     #
#    YOU BEGIN #
#         #
#################

# Get the PSTN Gateway ID as you will need this later
# Get-CsService -PSTNGateway -- Change this on "VOICE ROUTES" section
# Assumes Gateway is already set up.
#



#################
#         #
#    DIAL     #
#    PLAN     #
#         #
#################
# First create a Dial Plan
# Change "SiteADialPlan" name to whatever suits your organisation

New-CsDialPlan -Identity "SiteADialPlan-National"


#################
#         #
#    NUMBER     #
# NORMALIZATION #
#         #
#################

# Next Create Number Normalisation Rules for this plan.
# Only include the numbers you wish for these users to be able to access
# E.G. Dont put in premium etc...
# EXAMPLE BELOW
# New-CsVoiceNormalizationRule -Parent "SiteADialPlan" -Name "RULE NAME" -Description "Rule Description" -Pattern '^(\d{4})$' -Translation '+3531999$1'

New-CsVoiceNormalizationRule -Parent "SiteADialPlan-National" -Name "Emergency Services 999" -Description "Emergency Services 999" -Pattern '^(999)$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-National" -Name "Emergency Services 112" -Description "Emergency Services 112" -Pattern '^(112)$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-National" -Name "Speaking Clock 1191" -Description "Speaking Clock 1191" -Pattern '^(1191)$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-National" -Name "Telephone Cust services 19xx" -Description "Telephone Cust services 19xx" -Pattern '^(19\d{2})$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-National" -Name "116 Social Values" -Description "116 Social Values (Samaritans etc...)" -Pattern '^(116\d{3})$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-National" -Name "Directory Enquiries" -Description "Directory Enquiries" -Pattern '^(118\d{2})$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-National" -Name "08x IRL Mobiles" -Description "08x IRL Mobiles" -Pattern '^0(8\d{7}\d+)$' -Translation '+353$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-National" -Name "National Calls" -Description "National Calls" -Pattern '^0([1-9]\d{3}\d+)$' -Translation '+353$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-National" -Name "1800 FreePhone" -Description "1800 FreePhone" -Pattern '^(1800\d{6})$' -Translation '$1'

# Change below line depending on where the users are located - this rule is for Dublin users - 7 digits add 01
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-National" -Name "Local Calls within 01" -Description "Local Calls within 01 / 7 Digits" -Pattern '^(\d{7}t?)$' -Translation '+3531$1'


# Change below line depending on what the internal dialling extensions are
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-National" -Name "Int 4 digit Ext starting 1-8" -Description "Int 4 digit Ext starting 1-8" -Pattern '^([1-8]\d{3})$' -Translation '$1'

# These two rules may need to be applied to a separate Dial Plan if users are limited in calling per minute/per call numbers
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-National" -Name "1850 Fixed Cost" -Description "1850 Fixed Cost" -Pattern '^(1850\d{6})$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-National" -Name "1890 Per Minute" -Description "1890 Per Minute" -Pattern '^(1890\d{6})$' -Translation '$1'


#################
#         #
#    DIAL     #
#    PLAN     #
#         #
#################
#
# Create a new dialplan for International Calling allowed - this includes all the above plus extra
#
New-CsDialPlan -Identity "SiteADialPlan-International"

#################
#         #
#    NUMBER     #
# NORMALIZATION #
#         #
#################

New-CsVoiceNormalizationRule -Parent "SiteADialPlan-International" -Name "Emergency Services 999" -Description "Emergency Services 999" -Pattern '^(999)$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-International" -Name "Emergency Services 112" -Description "Emergency Services 112" -Pattern '^(112)$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-International" -Name "Speaking Clock 1191" -Description "Speaking Clock 1191" -Pattern '^(1191)$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-International" -Name "Telephone Cust services 19xx" -Description "Telephone Cust services 19xx" -Pattern '^(19\d{2})$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-International" -Name "116 Social Values" -Description "116 Social Values (Samaritans etc...)" -Pattern '^(116\d{3})$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-International" -Name "Directory Enquiries" -Description "Directory Enquiries" -Pattern '^(118\d{2})$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-International" -Name "08x IRL Mobiles" -Description "08x IRL Mobiles" -Pattern '^0(8\d{7}\d+)$' -Translation '+353$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-International" -Name "National Calls" -Description "National Calls" -Pattern '^0([1-9]\d{3}\d+)$' -Translation '+353$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-International" -Name "1800 FreePhone" -Description "1800 FreePhone" -Pattern '^(1800\d{6})$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-International" -Name "International Calls" -Description "International Calls" -Pattern '^00(\d*)$' -Translation '+$1'
# Change below line depending on where the users are located - this rule is for Dublin users - 7 digits add 01
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-International" -Name "Local Calls within 01" -Description "Local Calls within 01 / 7 Digits" -Pattern '^(\d{7}t?)$' -Translation '+3531$1'


# Change below line depending on what the internal dialling extensions are
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-International" -Name "Int 4 digit Ext starting 1-8" -Description "Int 4 digit Ext starting 1-8" -Pattern '^([1-8]\d{3})$' -Translation '$1'

# These two rules may need to be applied to a separate Dial Plan if users are limited in calling per minute/per call numbers
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-International" -Name "1850 Fixed Cost" -Description "1850 Fixed Cost" -Pattern '^(1850\d{6})$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-International" -Name "1890 Per Minute" -Description "1890 Per Minute" -Pattern '^(1890\d{6})$' -Translation '$1'


#################
#         #
#    DIAL     #
#    PLAN     #
#         #
#################
#
# Create a new dialplan for International Calling allowed - this includes all the above plus extra
#

New-CsDialPlan -Identity "SiteADialPlan-Premium"

#################
#         #
#    NUMBER     #
# NORMALIZATION #
#         #
#################

New-CsVoiceNormalizationRule -Parent "SiteADialPlan-Premium" -Name "Emergency Services 999" -Description "Emergency Services 999" -Pattern '^(999)$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-Premium" -Name "Emergency Services 112" -Description "Emergency Services 112" -Pattern '^(112)$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-Premium" -Name "Speaking Clock 1191" -Description "Speaking Clock 1191" -Pattern '^(1191)$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-Premium" -Name "Telephone Cust services 19xx" -Description "Telephone Cust services 19xx" -Pattern '^(19\d{2})$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-Premium" -Name "116 Social Values" -Description "116 Social Values (Samaritans etc...)" -Pattern '^(116\d{3})$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-Premium" -Name "Directory Enquiries" -Description "Directory Enquiries" -Pattern '^(118\d{2})$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-Premium" -Name "08x IRL Mobiles" -Description "08x IRL Mobiles" -Pattern '^0(8\d{7}\d+)$' -Translation '+353$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-Premium" -Name "National Calls" -Description "National Calls" -Pattern '^0([1-9]\d{3}\d+)$' -Translation '+353$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-Premium" -Name "1800 FreePhone" -Description "1800 FreePhone" -Pattern '^(1800\d{6})$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-Premium" -Name "International Calls" -Description "International Calls" -Pattern '^00(\d*)$' -Translation '+$1'

New-CsVoiceNormalizationRule -Parent "SiteADialPlan-Premium" -Name "15xx Premium Rate Numbers" -Description "15xx Premium Rate Numbers" -Pattern '^(15\d{8})$' -Translation '$1'
# Change below line depending on where the users are located - this rule is for Dublin users - 7 digits add 01
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-Premium" -Name "Local Calls within 01" -Description "Local Calls within 01 / 7 Digits" -Pattern '^(\d{7}t?)$' -Translation '+3531$1'


# Change below line depending on what the internal dialling extensions are
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-Premium" -Name "Int 4 digit Ext starting 1-8" -Description "Int 4 digit Ext starting 1-8" -Pattern '^([1-8]\d{3})$' -Translation '$1'

# These two rules may need to be applied to a separate Dial Plan if users are limited in calling per minute/per call numbers
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-Premium" -Name "1850 Fixed Cost" -Description "1850 Fixed Cost" -Pattern '^(1850\d{6})$' -Translation '$1'
New-CsVoiceNormalizationRule -Parent "SiteADialPlan-Premium" -Name "1890 Per Minute" -Description "1890 Per Minute" -Pattern '^(1890\d{6})$' -Translation '$1'

#################
#         #
#    VOICE     #
#    POLICIES #
#     &       #
#     PSTN     #
#    USAGES     #
#################
# Voice Policies are used to restrict calling number types to specific users
# PSTN Usage restricts calling certian numbers to specific PSTN Gateways (Used to restrict numbers overall also)

# SAMPLE VIOCE POLICY
#New-CSVoicePolicy "VOICE POLICY NAME" -Description "Allows calls to National Numbers Only" -WarningAction:SilentlyContinue

# National Policy
Set-CsPstnUsage -Usage @{Add="SiteA-National"}
New-CSVoicePolicy –Identity "SiteA - National Voice Policy" -Description "Allows calls to National Numbers Only" -PstnUsages @{Add = "SiteA-National"} -WarningAction:SilentlyContinue

# International Policy
Set-CsPstnUsage -Usage @{Add="SiteA-International"}
New-CSVoicePolicy –Identity "SiteA - International Voice Policy" -Description "Allows calls to International Numbers" -PstnUsages @{Add = "SiteA-International"} -WarningAction:SilentlyContinue

# Premium Policy
Set-CsPstnUsage -Usage @{Add="SiteA-Premium"}
New-CSVoicePolicy –Identity "SiteA - Premium Voice Policy" -Description "Unrestricted Policy" -PstnUsages @{Add = "SiteA-Premium"} -WarningAction:SilentlyContinue


#################
#         #
#    VOICE      #
#    ROUTES     #
#         #
#################
# Voice Routes send calls to different gateways or endpoints
# PSTNUsage and Gateway must exist in advance for this command to work
# SAMPLE ADD PSTN USAGE
#
# Set-CsPstnUsage -Usage @{Add="MGTESTUSAGE"}
#
# Get the PSTN Gateway ID as you will need this later
# Get-CsService -PSTNGateway
# SAMPLE VOICE ROUTE
# New-CsVoiceRoute -Identity Route1 -PstnUsages @{add="Long Distance"} -PstnGatewayList @{add="PstnGateway:redmondpool.litwareinc"}

New-CsVoiceRoute -Identity "SiteA-National-Route" -Description "Route for all Irish National Group Calls" -PstnUsages @{add="SiteA-National"} -PstnGatewayList @{add="PstnGateway:10.245.1.27"} -NumberPattern '^((\+353)|([1-9]))'

New-CsVoiceRoute -Identity "SiteA-International-Route" -Description "Route for all International Group Calls" -PstnUsages @{add="SiteA-International"} -PstnGatewayList @{add="PstnGateway:10.245.1.27"} -NumberPattern '.*'

New-CsVoiceRoute -Identity "SiteA-Premium-Route" -Description "Route for all Premium Group Calls" -PstnUsages @{add="SiteA-Premium"} -PstnGatewayList @{add="PstnGateway:10.245.1.27"} -NumberPattern '.*'

#
# Suppress Caller ID on a Route Level
# Example to supress ID, need both SuppressID and Alternate Number
# New-CsVoiceRoute -Identity International-Route -PstnUsages @{add="National"} -PstnGatewayList @{add="PstnGateway:GATEWAYFQDN"} -SuppressCallerId $true -AlternateCallerId "+35311234567"













































Comments

Post a Comment

Popular posts from this blog

Teams Device Health Monitoring and Reporting

By -
Image
 Microsoft have snuck in a nice new feature into the Teams Admin Center (TAC). We now see a new Notifications and Alerts  menu tree and below this Rules. When we go in here, we find only a single Default  Device State Rule with no option to create any new rules (yet at least...) When we edit this rule, we can see that we now have an option to monitor specific devices (think meeting room devices, collaboration bars etc.. here) Under Device users  we click on +ADD  then enter the name of the account, or accounts if you are monitoring multiple devices, associated with the device, such as the resource account. Then under Actions  we can choose either Channel alert  - to have a nice alert sent to our Teams Channel   OR Webhook  to use webhooks for alerting. Finally ensure to select Active  then Save. Once set up this will take maybe 15 mins to replicate and set up. Then once a device has gone offline, the alert will be sent "Immediately", how...
Read more

Unassigned Numbers in Microsoft Teams using Audiocodes SBC

By -
Image
Unlike Skype for Business, Microsoft Teams does not natively support the handling of Unassigned numbers in the system. So if someone leaves your organisation and you remove the number from them and someone tries to call it, the call will drop. Technically, Teams will return a "404 Not Found" back to the SBC and back on to the telco. What we can do here is to then assign the 404 error to a Route, change the Destination Number (to a call queue or to your main Reception number for example) and route it back to Teams. To do this there are a few simple steps: Step 1 – Create an Alternative Reasons Set Step 2 – Configure existing Teams IP Group to use the SBC Alternative Routing Reason Set Step 3 - Create new IPG Step 4 – Create a new route in IP-to-IP Routing Step 5 - Manipulate Numbers Step 6 – Test  Step 1 – Create an Alternative Reasons Set The first thing we need to do is create an " Alternative Routing Set ", we find this under Setup >> Signaling & Media ...
Read more

Skype for Business Edge Server replication troubleshooter

By -
Image
Many times in Skype for Business/Lync the main issue I come across is the deployment is that the edge server(s) fails to replicate. We see this when we run the command in Skype for Business Management Shell : Get-CsManagementStoreReplicationStatus and we see that the edge servers have False and no LastStatusReport or ProductVersion is shown as below. There are a number of things which can cause this and I am going to list them here. Try them in order here as this will contain the most common to the least common issues I found. Ø   Routing Ø   Firewall rules Ø   DNS suffix Ø   DNS (Local and LAN) Ø   Registry entries for SCHANNEL Ø   Certificates A check we can use to see if the replication is working can be done by trying to connect to the following URL from the Front End Server whish hosts the CMS: https://edgeinternalfqdn.domain.ie:4443/Replicationwebservice You should get the following screen: Without thi...
Read more