Get-CSUserSessionGUI

By | October 24, 2016

Earlier this month I blogged about the Session Details(Preview) in the Skype for Business Online admin portal, which can be found at: http://realtimeuc.com/2016/10/sfbo-session-details-preview/ a welcome addition to the portal! On the flip side I do prefer managing my tenants via PowerShell vs. hanging out in the browser. Here comes the Get-CSUserSession cmdlet. One thing to note is TechNet references a -StartDate parameter which actually should be -StartTime, I did submit this feedback back to Microsoft in July. The great thing about Get-CSUserSession is you also get access to Error Reports and Registration events that are not visible in the admin portal.

Figuring that it has been a while since my last PowerShell GUI script, Get-CSUserSession seemed right for the picking. Hence today’s release of Get-CSUserSessionGUI which can be found on the TechNet Gallery.
Script Download: Get-CSUserSessionGUI.ps1 https://gallery.technet.microsoft.com/Get-CSUserSessoinGUI-ac6992f2

Get-CSUserSessionGUI is a PowerShell GUI script that connects to your Skype for Business Online tenant to run Get-CSUserSession queries. This will allow you to retrieve user session information within a specified period. Ideal for troubleshooting Cloud PBX or other Skype for Business Online modalities.

Features:

  • Double clicking a line item will copy row into clipboard
  • Keyboard press of “+” will expand all child rows under current selection
  • Keyboard press of “-” will collapse the selected row and child items
  • “Export All” button will save all rows to specified text file

A prerequisite for the script is the Skype for Business Online Windows PowerShell Module: https://www.microsoft.com/en-us/download/details.aspx?id=39366

Once launching Get-CSUserSessionGUI, click “Connect to SFBO” and enter in your Skype for Business Online credentials.
us-1

After the script connects, it will take a few moments to populate the “SIP Address” drop-down based on the number of users configured in the tenant. Took about 45 seconds for 4000 users in my testing. Now with the list populated, select the desired user. You can speed up the process by typing the first letter of the user’s address.
us-2a

Selecting the “Duration” will determine how much time from the current time to search for User Session data.
us-2b

Clicking “Submit” will run the crafted search and populate a TreeView with the results. Clicking the “+” next to a line will expand a single item, alternatively pressing “+” on the keyboard will expand all sub items under the selected item. Clicking the “-” next to a line will collapse the selected item, alternatively pressing “-” on the keyboard will collapse all sub items under the selected item.
us-2

Double clicking an item will copy the highlighted item to the clipboard, there is extra logic for double clicking a “DiagnosticHeader..” line and the row will be formatted for better viewing into the clipboard.
us-4

The “Export All” button will prompt for a file to save all rows and sub items.
us-3

Script Download: Get-CSUserSessionGUI.ps1 https://gallery.technet.microsoft.com/Get-CSUserSessoinGUI-ac6992f2

3 thoughts on “Get-CSUserSessionGUI

  1. Pingback: Skype for Business Cloud Connector Edition (CCE) – Operation was unsuccessful (504 Server time-out) |

  2. Pingback: Skype for Business Cloud Connector Edition (CCE) – We couldn’t reach +1XXXXXXXXXX (404 Not Found) |

Leave a Comment