- Vik Jaswal
PowerShell Module for Sonus SBC 1000-2000
It’s finally here!!!! PowerShell module for Sonus SBC 1000/2000. Well it’s not an official one, but one I created out of necessity when managing numerous SBC’s.
Key Features
Built-in cmdlets to query Sonus SBC for transformation tables, transformation entries, systems information, etc.
Built-in cmdlets to create transformation tables and transformation entries
Built-in cmdlets to reboot and backup Sonus SBC
Extensibility – Query, create, modify and delete any UX resource even the one’s which don’t have cmdlets associated!
Scalability – Manage Sonus SBC’s at scale. Query, create, modify and delete resources with extraordinary efficiency. 1 or 100 SBC’s, it doesn’t matter!
Simplicity – Extremely simple to use, logical cmdlet naming and in-depth built-in help.
Pre-requisites
Sonus SBC software should be R3.0 or higher
PowerShell v 3.0 or higher
Ensure you have applied the base version 3.0 license which contains the license for REST
Ensure you have created a username and password for REST. For more details check out: http://www.allthingsuc.co.uk/accessing-sonus-ux-with-rest-apis/
Getting Started
Download the SonusUX PowerShell module from here
Copy the module to your machine. Ideally you want to copy the module to one of the following locations as these are default locations where PowerShell looks for modules when import-module is executed.
C:\Users\YOURUSERNAME\Documents\WindowsPowerShell\Modules
C:\Windows\system32\WindowsPowerShell\v1.0\Modules
Open PowerShell and import the module:
If the module is in one of the above locations (where PowerShell searches), you can just execute import-module SonusUX
If the module is not in the default location you can execute import-module C:\SonusUX\SonusUX.psm1 (replacing the path where you have copied the module to)
To discover what cmdlets are available execute: get-command –module SonusUX. Full PowerShell cmdlet help is available for all cmdlets.
The first cmdlet you need to use is connect-uxgateway. The screenshot below shows the complete syntax. Once connected you can start using other cmdlets.
Cmdlet Execution
Below is the output of some of the cmdlets:
Get call statistics from Sonus SBC
Get-uxsystemscallstats
Get system information
Get-uxsysteminfo
Get transformation table
Get-uxtransformationtable
Get transformation table entries from a specified Transformation table
get-uxtransformationentry -uxtransformationtableid 11
Create Transformation table
new-uxtransformationtable -Description “LyncToPBX”
Create Transformation entry
new-uxtransformationentry -TransformationTableId 9 -InputFieldType 3 -InputFieldValue ‘(.*)’ -OutputFieldType 3 -OutputFieldValue ‘\1’ -Description “PassthroughCLI” -MatchType 0
Advanced Cmdlet Execution
And just to get you started, below are some Powershell one liners you can use to query multiple SBC’s!
Query number of calls currently up on the SBC’s
“lyncgwy1”, “lyncgwy2” | % { connect-uxgateway -uxhostname $_ -uxusername restuser -uxpassword Password01 ; (get-uxsystemcallstats).rt_NumCallCurrentlyUp}
Query the Hardware ID of the SBC’s
“lyncgwy1”, “lyncgwy2” | % { connect-uxgateway -uxhostname $_ -uxusername restuser -uxpassword Password01 ; (get-uxsysteminfo).rt_Chassis_Hardware_ID}
The below command will query the gateways in Lync topology and than query them for all the transformation tables
Get-CsService -PstnGateway | select -ExpandProperty poolfqdn | % { connect-uxgateway -uxhostname $_ -uxusername restuser -uxpassword Password01; write-host “`n$uxhostname” -ForegroundColor Green ;get-uxtransformationtable}
The below command will query the gateways in Lync topology and create backup of its configuration
Get-CsService -PstnGateway | select -ExpandProperty poolfqdn | % {connect-uxgateway -uxhostname $_ -uxusername restuser -uxpassword Password01; invoke-uxbackup -backupdestination c:\UXbackup -backupfilename $_ }
Copy transformation table entries from one transformation table to another on the Sonus SBC
get-uxtransformationentry -uxtransformationtableid 12 | Sort-Object sequenceid |%{ new-uxtransformationentry -TransformationTableId 1 -InputFieldType $_.inputfield -InputFieldValue $_.inputfieldvalue -OutputFieldType $_.outputfield -OutputFieldValue $_.outputfieldvalue -Description $_.description -MatchType $_.matchtype }
Copy transformation table entries from one Sonus SBC to another (Ok, now this certainly isn’t a one liner and I wouldn’t really recommened to use this method as it creates are new connection on destination Sonus SBC for every entry it creates from source, I rather prefer doing a little script, but hey, I just wanted to demonstrate how powerful this is!)
connect-uxgateway -uxhostname Sourcelyncgw1 -uxusername restuser -uxpassword Password01;get-uxtransformationentry -uxtransformationtableid 1 | Sort-Object sequenceid | % {connect-uxgateway -uxhostname Destlyncgw1 -uxusername restuser -uxpassword Password02;new-uxtransformationentry -TransformationTableId 1 -InputFieldType $_.inputfield -InputFieldValue $_.inputfieldvalue -OutputFieldType $_.outputfield -OutputFieldValue $_.outputfieldvalue -Description $_.description -MatchType $_.matchtype}
As you can see the possibilities are immense and hopefully this module will help you to be more efficient at deploying and managing Sonus devices. You can also quite easily extend the module (leverage get-command *-uxresource cmdlets to make your life easy!) and create advanced scripts using the existing cmdlets. Please feel free to provide any feedback or let me know what other cmdlets you would like to see in future updates or if you update the module please send me a copy to share with the community.
Enjoy!
Vik