Get-CsUserSession

Reference

Module:: SkypeForBusiness

Applies to:: Skype for Business Online

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.

Jaa