Get-CsUserSession

Use the Get-CsUserSession cmdlet to retrieve user session information within a specified date range within the past 30 days.

Syntax

Get-CsUserSession
   -StartTime <DateTimeOffset>
   -User <String>
   [-EndTime <DateTimeOffset>]
   [<CommonParameters>]

Description

Deprecation Notice: We will be retiring this feature and cmdlet from Skype for Business Online beginning 5/30/2020. Instead, we recommend the utilization of MS Graph Call Records API, which is where we will continue to invest our development resources. For more information, see /graph/api/resources/callrecords-api-overview?view=graph-rest-beta.

Use the Get-CsUserSession cmdlet to retrieve session information for users within a specified date range within the past 30 days.

You have to be assigned Skype For Business admin role to run this cmdlet.

Examples

-------------------------- Example 1 --------------------------

Get-CsUserSession -User "Ken.Myer@Contoso.com" -StartTime "02/22/2016 07:30:15 PM"

This example returns user session information for Ken Myer from "02/22/2016 07:30:15 PM" to the current date.

Parameters

-EndTime

Specifies the end date, time and offset of the date range.

Type:DateTimeOffset
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online

-StartTime

Specifies the start date, time and offset of the date range.

Type:DateTimeOffset
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online

-User

Specifies the user whose session data will be retrieved. The input format is any form of user URI defined in Skype for Business Online. For instance: -User "Ken.Myer@Contoso.com".

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online

Inputs

None.

Outputs

The Get-CsUserSession cmdlet returns an instance of the Microsoft.Rtc.Management.Hosted.Data.UserSession object.