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:
- Part 1 – Prerequisites and Installation: Set up a Trusted Application Server and get SEFAUtil to run
- Part 2 – Perform configuration using the tool
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.
The following tables show all switches in categories:
|/server||Lync Server FQDN, required if auto-discovery is not enabled|
|No switches||Displays the call forwarding settings of the user.|
|/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
|/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|
Simultaneous ringing commands
|/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
|/enablegrouppickup||Enables group pickup|
|/disablegrouppickup||Disables group pickup|
Team call commands
|/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:email@example.com /server:pool1.lab.local
The result looks something like this:
Change the configuration
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:firstname.lastname@example.org /server:pool1.lab.local /enablesimulring /setsimulringdestination:"sip:email@example.com"
.\SEFAUtil.exe sip:firstname.lastname@example.org /server:pool1.lab.local /enablesimulring /setsimulringdestination:"sip:+email@example.com;user=phone"
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:firstname.lastname@example.org /server:pool1.lab.local /setfwddestination:"sip:email@example.com;opaque=app:voicemail" /enablefwdnoanswer /callanswerwaittime:20
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:firstname.lastname@example.org /server:pool1.lab.local /addteammember:sip:email@example.com /delayringteam:10 .\SEFAUtil.exe sip:firstname.lastname@example.org /server:pool1.lab.local /addteammember:sip:email@example.com
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.
Latest posts by Simone (see all)
- Office Online Server with Skype for Business – Deployment - 1. July 2016
- Quickie: Mainstream support for Lync 2010 ending soon - 23. February 2016
- Using SEFAUtil – Part 2 – Perform configuration using the tool - 21. July 2015