ucready

Using SEFAUtil – Part 2 – Perform configuration using the tool

Using SEFAUtil – Part 2 – Perform configuration using the tool

In part 1 of this series I covered the installation of SEFAUtil and how to get it to run. This part will focus on using the tool and what commands can look like.

This two part series of posts is all about SEFAUtil:

Available Switches

SEFAUtil comes with various switches, which allow you to get or make configurations for features like delegate ringing, call forwarding, etc. You can get a list of all available switches by starting the tool without typing a command. The tool location varies depending on which Microsoft UC version you are using.

1

The following tables show all switches in categories:

General commands

Command Description
/server Lync Server FQDN, required if auto-discovery is not enabled
No switches Displays the call forwarding settings of the user.

Delegate commands

Command Description
/adddelegate Add delegate on-behalf of the user
/removedelegate Removes delegate on behalf of the user
/simulringdelegates Sets user’s call handling rules to ring delegates endpoints simultaneously
/delayringdelegates Sets number of seconds boss’ endpoints ring before ringing delegates
/fwdtodelegates Sets user’s call handling rules to forward calls to delegates
/disabledelegation Disables delegate ringing for the user

Call forwarding commands

Command Description
/setfwddestination Sets the user’s forward immediate or forward-no-answer destination
/enablefwdimmediate Sets user’s call handling rules to immediately forward all calls to fwd destination
/enablefwdnoanswer Sets user’s call handling rules to forward unanswered calls to fwd destination
/callanswerwaittime Sets the number of seconds to wait for user to pick up the call
/disablefwdimmediate Disables forward immediate
/disablefwdnoanswer Disables forward-no-answer

Simultaneous ringing commands

Command Description
 /setsimulringdestination Sets the user’s simul ring destination
/enablesimulring Sets user’s call handling rules to simul ring calls to simul ring destination
/disablesimulring Disables simul ring

Pickup Group commands

Command Description
/enablegrouppickup Enables group pickup
/disablegrouppickup Disables group pickup

Team call commands

Command Description
/addteammember Add team member on-behalf of the user
/removeteammember Removes team member on behalf of the user
/simulringteam Sets user’s call handling rules to ring team member endpoints simultaneously
/delayringteam Sets number of seconds user’s endpoints ring before ringing team members
/disableteamcall Disables team ringing for the user

 

Examples for commands

I will cover the SEFAUtil commands for some basic tasks. These are just examples, of course you can just use other switches to accomplish other tasks.

You always run the commands for one user at a time, which will be identified by the SIP URI.

Get the current configuration 

First thing you probably want to do, is to get the current configuration for the user you are working on.

.\SEFAUtil.exe sip:<SIP URI> /server:<FQDN of registrar pool>
.\SEFAUtil.exe sip:simone.liebal@lab.local /server:pool1.lab.local

The result looks something like this:

2

 

Change the configuration

Example 1:

This will enable simultaneous ringing for incoming calls.

.\SEFAUtil.exe sip:<SIP URI> /server:<FQDN of registrar pool> /enablesimulring /setsimulringdestination:"sip:<SIP URI / phonenumber@domain;user=phone>"
.\SEFAUtil.exe sip:simone.liebal@lab.local /server:pool1.lab.local /enablesimulring /setsimulringdestination:"sip:ted.test@lab.local"
.\SEFAUtil.exe sip:simone.liebal@lab.local /server:pool1.lab.local /enablesimulring /setsimulringdestination:"sip:+4911111111111@lab.local;user=phone"

Example 2:

If an incoming call is not answered within 20 seconds, it will be forwarded to the user’s voicemail.

.\SEFAUtil.exe sip:<SIP URI> /server:<FQDN of registrar pool> /setfwddestination:"sip:<SIP URI>;opaque=app:voicemail" /enablefwdnoanswer /callanswerwaittime:<time in seconds>
.\SEFAUtil.exe sip:simone.liebal@lab.local /server:pool1.lab.local /setfwddestination:"sip:simone.liebal@lab.local;opaque=app:voicemail" /enablefwdnoanswer /callanswerwaittime:20

Example 3:

This will add members to your team. Incoming calls will ring your team, if the call is not answered within 10 seconds. Unfortunately there is no way (or at least I don’t know it) to add all team members within one command. Therefore it can be quite a lengthy process to add team members. I usually write out the commands in advance and then just copy the whole section into PowerShell.

These commands only add team members to the user you defined with sip:<SIP URI> (in this case at the beginning of each command). So you may have to repeat these commands for the other user within the team.

.\SEFAUtil.exe sip:<SIP URI> /server:<FQDN of registrar pool> /addteammember:sip:<SIP URI team member A> /delayringteam:<time in seconds> 
.\SEFAUtil.exe sip:<SIP URI> /server:<FQDN of registrar pool> /addteammember:sip:<SIP URI team member B>
.\SEFAUtil.exe sip:simone.liebal@lab.local /server:pool1.lab.local /addteammember:sip:ted.test@lab.local /delayringteam:10
.\SEFAUtil.exe sip:simone.liebal@lab.local /server:pool1.lab.local /addteammember:sip:toni.test@lab.local

Simone

Simone

My name is Simone Liebal and I’m working as a Cloud Solution Architect at Microsoft in Germany with the focus point on Cloud Voice.
I support partners with their Skype for Business projects and offerings following the Skype Operations Framework.

Opinions displayed on this blog and my social media pages are my own and do not express the views and opinions of Microsoft.
Simone

Leave a Reply

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

*