Documentation Index

Fetch the complete documentation index at: https://support.nectarcorp.com/llms.txt

Use this file to discover all available pages before exploring further.

Get-NectarSessionCount

  • Updated on Aug 1, 2023
  • Published on May 6, 2021
  • 12 minute(s) read
Prev Next

Returns session counts broken down by hour/day (depending on selected time filter) for a given timeframe. Includes breakdown by quality and NectarScore by hour/day.

Description

Returns session counts broken down by hour/day (depending on selected time filter) for a given timeframe. This returns the numbers used to build the chart in the SESSIONS section of the CALL DETAILS screen

Syntax

Get-NectarSessionCount
  -TimePeriod  <String>
  -TimePeriodFrom  <String>
  -TimePeriodTo  <String>
  -SessionQualities  <String[]>
  -DurationFrom  <Int32>
  -DurationTo  <Int32>
  -Modalities  <String[]>
  -Protocols  <String[]>
  -ResponseCodes  <String[]>
  -SessionScenarios  <String[]>
  -SessionTypes  <String[]>
  -Codecs  <String[]>
  -CallerCodecs  <String[]>
  -CalleeCodecs  <String[]>
  -Devices  <String[]>
  -CallerDevices  <String[]>
  -CalleeDevices  <String[]>
  -DeviceVersions  <String[]>
  -CallerDeviceVersions  <String[]>
  -CalleeDeviceVersions  <String[]>
  -IPAddresses  <IPAddress[]>
  -CallerIPAddresses  <IPAddress[]>
  -CalleeIPAddresses  <IPAddress[]>
  -Locations  <String[]>
  -CallerLocations  <String[]>
  -CalleeLocations  <String[]>
  -ExtCities  <String[]>
  -CallerExtCities  <String[]>
  -CalleeExtCities  <String[]>
  -ExtCountries  <String[]>
  -CallerExtCountries  <String[]>
  -CalleeExtCountries  <String[]>
  -ExtISPs  <String[]>
  -CallerExtISPs  <String[]>
  -CalleeExtISPs  <String[]>
  -ExtConnectionTypes <String[]>
  -CallerExtConnectionTypes <String[]>
  -CalleeExtConnectionTypes <String[]>
  -NetworkTypes  <String[]>
  -CallerNetworkTypes  <String[]>
  -CalleeNetworkTypes  <String[]>
  -Platforms  <String[]>
  -Users  <String[]>
  -FromUsers  <String[]>
  -ToUsers  <String[]>
  -ConfOrganizers  <String[]>
  -VPN  <String[]>
  -CallerVPN  <String[]>
  -CalleeVPN  <String[]>
  -ParticipantsMinCount  <Int32>
  -ParticipantsMaxCount  <Int32>
  -FeedbackRating  <String[]>
  -TenantName  <String>

Examples

Example 1

Get-NectarSessionCount -TimePeriod LAST_DAY

Returns an hour-by-hour count of the number of sessions occuring over the past day along with quality breakdown

Example 2

Get-NectarSessionCount -TimePeriod LAST_WEEK -Platform TEAMS

Returns an day-by-day count of the number of sessions occuring over the past week along with quality breakdown for MS Teams

Parameters

-TimePeriod <String>
The time period to show session data from. Select from 'LAST_HOUR','LAST_DAY','LAST_WEEK','LAST_MONTH','CUSTOM'.
CUSTOM requires using TimePeriodFrom and TimePeriodTo parameters.

Parameter Value
Required false
Position 1
Required false
Default Value LAST_HOUR
Accept pipeline input? false
Accept wildcard characters? false

-TimePeriodFrom <String>
The earliest date/time to show session data from. Must be used in conjunction with -TimePeriod CUSTOM and TimePeriodTo parameters. Use format 'YYYY-MM-DD' or 'YYYY-MM-DD HH:MM:SS'. All time/dates in UTC.

Parameter Value
Required false
Position 2
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-TimePeriodTo <String>
The latest date/time to show session data from. Must be used in conjunction with -TimePeriod CUSTOM and TimePeriodFrom parameters. Use format 'YYYY-MM-DD' or 'YYYY-MM-DD HH:MM:SS'. All time/dates in UTC.

Parameter Value
Required false
Position 3
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-SessionQualities <String[]>
Show sessions that match a given quality rating. Case sensitive. Choose one or more from:
'GOOD','POOR_0_25','PARTIALLY_GOOD_25_50','PARTIALLY_GOOD_50_75','PARTIALLY_GOOD_75_100','UNAVAILABLE','UNKNOWN'

Parameter Value
Required false
Position 4
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-DurationFrom <Int32>
The shortest call length (in seconds) to show session data.

Parameter Value
Required false
Position 5
Required false
Default Value 0
Accept pipeline input? false
Accept wildcard characters? false

-DurationTo <Int32>
The longest call length (in seconds) to show session data.

Parameter Value
Required false
Position 6
Required false
Default Value 99999999
Accept pipeline input? false
Accept wildcard characters? false

-Modalities <String[]>
Show sessions that match one or more modality types. Not case sensitive. Choose one or more from:
'AUDIO','VIDEO','APP_SHARING','FILE_TRANSFER','IM','UNKNOWN','TOTAL','VBSS','REMOTE_ASSISTANCE','APP_INVITE','FOCUS','UNKNOWN'

Parameter Value
Required false
Position 7
Required false
Default Value TOTAL
Accept pipeline input? false
Accept wildcard characters? false

-Protocols <String[]>
Show sessions that match one or more network protocol types. Case sensitive. Choose one or more from:
'TCP','UDP','Unknown'

Parameter Value
Required false
Position 8
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-ResponseCodes <String[]>
Show sessions that match one or more SIP response codes. Accepts numbers from 200 to 699

Parameter Value
Required false
Position 9
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-SessionScenarios <String[]>
Show sessions that match one or more session scenarios. Not case sensitive. Choose one or more from:
'External','Internal','Internal-External','External-Internal','Federated','Internal-Federated','External-Federated','Unknown'

Parameter Value
Required false
Position 10
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-SessionTypes <String[]>
Show sessions that match one or more session scenarios. Case sensitive. Choose one or more from:
'Conference','Peer To Peer','Peer To Peer (Multimedia)','PSTN/External'

Parameter Value
Required false
Position 11
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-Codecs <String[]>
Show sessions where the selected codec was used by either caller or callee. Can query for multiple codecs. Case sensitive. Use Get-NectarCodecs for a list of valid codecs.

Parameter Value
Required false
Position 12
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-CallerCodecs <String[]>
Show sessions where the selected codec was used by the caller. Can query for multiple codecs. Case sensitive. Use Get-NectarCodecs for a list of valid codecs.

Parameter Value
Required false
Position 13
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-CalleeCodecs <String[]>
Show sessions where the selected codec was used by the callee. Can query for multiple codecs. Case sensitive. Use Get-NectarCodecs for a list of valid codecs.

Parameter Value
Required false
Position 14
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-Devices <String[]>
Show sessions where the selected device was used by either caller or callee. Can query for multiple devices. Case sensitive. Use Get-NectarSupportedDevice for a list of valid devices.

Parameter Value
Required false
Position 15
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CallerDevices <String[]>
Show sessions where the selected device was used by the caller. Can query for multiple devices. Case sensitive. Use Get-NectarSupportedDevice for a list of valid devices.

Parameter Value
Required false
Position 16
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CalleeDevices <String[]>
Show sessions where the selected device was used by the callee. Can query for multiple devices. Case sensitive. Use Get-NectarSupportedDevice for a list of valid devices.

Parameter Value
Required false
Position 17
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-DeviceVersions <String[]>
Show sessions where the selected device version was used by either caller or callee. Can query for multiple devices. Case sensitive. Use Get-NectarClientVersion for a list of valid client versions.

Parameter Value
Required false
Position 24
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CallerDeviceVersions <String[]>
Show sessions where the selected device version was used by the caller. Can query for multiple devices. Case sensitive. Use Get-NectarClientVersion for a list of valid client versions.

Parameter Value
Required false
Position 25
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CalleeDeviceVersions <String[]>
Show sessions where the selected device version was used by the callee. Can query for multiple devices. Case sensitive. Use Get-NectarClientVersion for a list of valid client versions.

Parameter Value
Required false
Position 26
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-IPAddresses <IPAddress[]>
Show sessions where the selected IP address was used by either caller or callee. Can query for multiple IPs.

Parameter Value
Required false
Position 27
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CallerIPAddresses <IPAddress[]>
Show sessions where the selected IP address was used by the caller. Can query for multiple IPs.

Parameter Value
Required false
Position 28
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CalleeIPAddresses <IPAddress[]>
Show sessions where the selected IP address was used by the callee. Can query for multiple IPs.

Parameter Value
Required false
Position 29
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Locations <String[]>
Show sessions where the selected location was used by either caller or callee. Can query for multiple locations.

Parameter Value
Required false
Position 30
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CallerLocations <String[]>
Show sessions where the selected location was used by the caller. Can query for multiple locations.

Parameter Value
Required false
Position 31
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CalleeLocations <String[]>
Show sessions where the selected location was used by the callee. Can query for multiple locations.

Parameter Value
Required false
Position 32
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-ExtCities <String[]>
Show sessions where the caller or callee was located in the selected city (as detected via geolocating the user's external IP address). Can query for multiple cities.

Parameter Value
Required false
Position 33
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CallerExtCities <String[]>
Show sessions where the caller was located in the selected city (as detected via geolocating the user's external IP address). Can query for multiple cities.

Parameter Value
Required false
Position 34
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CalleeExtCities <String[]>
Show sessions where the callee was located in the selected city (as detected via geolocating the user's external IP address). Can query for multiple cities.

Parameter Value
Required false
Position 35
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-ExtCountries <String[]>
Show sessions where the caller or callee was located in the selected country (as detected via geolocating the user's external IP address). Can query for multiple countries.

Parameter Value
Required false
Position 36
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CallerExtCountries <String[]>
Show sessions where the caller was located in the selected country (as detected via geolocating the user's external IP address). Can query for multiple countries.

Parameter Value
Required false
Position 37
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CalleeExtCountries <String[]>
Show sessions where the callee was located in the selected country (as detected via geolocating the user's external IP address). Can query for multiple countries.

Parameter Value
Required false
Position 38
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-ExtISPs <String[]>
Show sessions where the caller or callee was located in the selected ISP (as detected via geolocating the user's external IP address). Can query for multiple ISPs.

Parameter Value
Required false
Position 39
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CallerExtISPs <String[]>
Show sessions where the caller was located in the selected ISP (as detected via geolocating the user's external IP address). Can query for multiple ISPs.

Parameter Value
Required false
Position 40
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CalleeExtISPs <String[]>
Show sessions where the callee was located in the selected ISP (as detected via geolocating the user's external IP address). Can query for multiple ISPs.

Parameter Value
Required false
Position 41
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-ExtConnectionTypes <String[]>
Show sessions that match the caller or callee external connection type (as detected via geolocating the user's external IP address). Can query for multiple types.

Parameter Value
Required false
Position named
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CallerExtConnectionTypes <String[]>
Show sessions that match the caller external connection type (as detected via geolocating the user's external IP address). Can query for multiple types.

Parameter Value
Required false
Position named
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-CalleeExtConnectionTypes <String[]>
Show sessions that match the callee external connection type (as detected via geolocating the user's external IP address). Can query for multiple types.

Parameter Value
Required false
Position named
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-NetworkTypes <String[]>
Show sessions where the selected network type was used by either caller or callee. Can query for multiple network types. Case sensitive. Choose one or more from:
'Enterprise WiFi','Enterprise Wired','External Mobile','External WiFi','External Wired','Unknown','Unavailable'
Parameter Value
---- ----
Required false
Position named
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-NetworkTypes <String[]>
Show sessions where the selected network type was used by either caller or callee. Can query for multiple network types. Case sensitive. Choose one or more from:
'Enterprise WiFi','Enterprise Wired','External Mobile','External WiFi','External Wired','Unknown','Unavailable'

Parameter Value
Required false
Position 42
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-CallerNetworkTypes <String[]>
Show sessions where the selected network type was used by the caller. Can query for multiple network types. Case sensitive. Choose one or more from:
'Enterprise WiFi','Enterprise Wired','External Mobile','External WiFi','External Wired','Unknown','Unavailable'

Parameter Value
Required false
Position 43
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-CalleeNetworkTypes <String[]>
Show sessions where the selected network type was used by the callee. Can query for multiple network types. Case sensitive. Choose one or more from:
'Enterprise WiFi','Enterprise Wired','External Mobile','External WiFi','External Wired','Unknown','Unavailable'

Parameter Value
Required false
Position 44
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-Platforms <String[]>
Show sessions where the selected platform was used by either caller or callee. Can query for multiple platforms. Case sensitive. Choose one or more from:
'SKYPE','CISCO','CISCO_CMS','CISCO_VKM','TEAMS','SKYPE_ONLINE','CISCO_CMS_VKM','AVAYA_AURA_CM','RIG','LYNC_VKM','SKYPE_FOR_BUSINESS_VKM','CISCO_UNITY','CISCO_EXPRESSWAY','AVAYA_MEDIA_GATEWAY','AVAYA_SESSION_MANAGER','AVAYA_VOICE_PORTAL','ZOOM','ENDPOINT_CLIENT','MISCELLANEOUS'

Parameter Value
Required false
Position 45
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-Users <String[]>
Show sessions where the selected user was either caller or callee. Can query for multiple users.

Parameter Value
Required false
Position 54
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-FromUsers <String[]>
Show sessions where the selected user was the caller. Can query for multiple users.

Parameter Value
Required false
Position 55
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-ToUsers <String[]>
Show sessions where the selected user was the callee. Can query for multiple users.

Parameter Value
Required false
Position 56
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-ConfOrganizers <String[]>
Show sessions hosted by a specified conference organizer. Can query for multiple organizers.

Parameter Value
Required false
Position 57
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-VPN <String[]>
Show sessions where the selected VPN was used by either caller or callee.

Parameter Value
Required false
Position 58
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-CallerVPN <String[]>
Show sessions where the selected VPN was used by the caller.

Parameter Value
Required false
Position 59
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-CalleeVPN <String[]>
Show sessions where the selected VPN was used by the callee.

Parameter Value
Required false
Position 60
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-ParticipantsMinCount <Int32>
Show sessions where the number of participants is greater than or equal to the entered value

Parameter Value
Required false
Position 61
Required false
Default Value 0
Accept pipeline input? false
Accept wildcard characters? false

-ParticipantsMaxCount <Int32>
Show sessions where the number of participants is less than or equal to the entered value

Parameter Value
Required false
Position 62
Required false
Default Value 0
Accept pipeline input? false
Accept wildcard characters? false

-FeedbackRating <String[]>
Show sessions where users provided specific feedback ratings from BAD to EXCELLENT.
Allowed values are BAD, POOR, FAIR, GOOD, EXCELLENT. Corresponds to ratings from 1 to 5 stars.

Parameter Value
Required false
Position 63
Required false
Default Value None
Accept pipeline input? false
Accept wildcard characters? false

-TenantName <String>
The name of the Nectar DXP tenant. Used in multi-tenant configurations.

Parameter Value
Required false
Position 64
Required false
Default Value None
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false