So, I was getting tired of sefautil not existing in PowerShell… this isn’t that entirely, but stay tuned.
The purpose of this tool is to give you an easy front end GUI to review your user’s call forwarding settings. Information such as who’s a delegate of who, who’s got simultaneous ring set, who’s forwarding where, etc. can be difficult to retrieve without a utility such as sefautil. Sefautil in itself can be difficult. This tool allows you to review this information for all users in a pool in a GUI format that’s easily searchable, sortable, and filterable (Out-Gridview). It also allows you to save the information to a CSV file. The information is gathered by parsing data pulled using Export-CSUserData. No SQL calls are made and no data is written back into Lync.
Because this tool uses Export-CSUserData, please be patient during the loading process. If you have difficulty using this utility, first ensure you can run Export-CSUserData successfully. If there is any corrupted user information in a pool, this can cause issues and that corruption will need to be resolved first.
If you would like to see the information in a different format, say a PowerShell command such as Get-CSUserForwardingInfo that can run for a single user or pool for speed, let me know as well. If there’s interest I can write it. Though it runs fine on Skype for Business, a separate Skype for Business utility will be released as well with additional information related to Call Via Work.
Finally, the question that I imagine will be asked is: If you can pull this data as read-only, why not give the ability to modify and write it back and avoid sefautil all together? The quick answer is: I have another utility for this that I have not yet released, and reading the data is much simpler than writing it. I am still putting it through it’s paces for quality and will decide if it should be released later.
A quick description of the columns is below:
- SIP Address: The Lync account’s sip address.
- Action: The action to be performed when a call comes in.
- Applied During Work Hours: True or False based upon if “During work hours set in Outlook” is set.
- Forwarding To: Set if call forwarding is enabled.
- Simultaneous Ring To: Set is simultaneous ring is enabled.
- No Answer To: If there’s no answer, should voicemail be attempted or a custom number?
- No Answer In Seconds: How many seconds until voicemail (or “No Answer To” setting) is attempted?
- Seconds Until Delegate or Group Rings: This is the delay set until other delegates or a team group hear a ring. This is to allow the recipient to answer the phone first.
- All Delegates: This is a basic list of all of your delegates.
- Delegates that Receive Calls: This is a list of the delegates for which the user has set the ability to receive their calls.
- Team Group: A listing of users in the team-call group
The Action column will show some somewhat cryptic output. There are a few fields you commonly see in there. Changing your own forwarding settings and reviewing the output can help you learn what these mean (and help me find any bugs). In the mean time here are a few to get you started:
- Column is empty: Call forwarding is not set.
- enablecf forward_immediate: Call forwarding is set. Review the Forwarding To column.
- forward_immediate (without enablecf): Typically forward directly into voicemail.
- enablecf (no forward_immediate): Typically means a custom forward on no answer exists. Review the No Answer To column.
- simultaneous_ring: Simultaneous ring is set up, review the Simultaneous Ring To column.
- work_hours: “During work hours set in Outlook” is set.
- delegate_ring forward_audio_app_invites: Simultaneously ring the delegates.
- delegate_ring forward_audio_app_invites skip_primary: Forward to the delegates.
- team_ring: Simultaneously ring the team group
If you’re not familiar with Out-GridView, the GUI portion that allows you to sort and filter, it’s simple to use. Click on a column heading to sort, and to filter, click the Add criteria button and list your settings. For example, if you wanted to find out every user that had Abraham Lincoln listed as a delegate, you could Add the criteria “All Delegates”, set it to contains, and add a portion of Honest Abe’s SIP address.
To run the tool, just download it from the link below, run it from a Lync Management Shell. If you have any questions, find any bugs, or anything else, the best place to ask is in the TechNet gallery. Thank you and I hope you find it useful!