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-NectarModalityQualitySummary

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

Returns summary quality information for different modalities over a given timeperiod.

Description

Returns summary quality information for audio, video and appsharing modalities. Used to build the QUALITY section of the CALL DETAILS screen.

Syntax

Get-NectarModalityQualitySummary
  -Modality  <String>
  -TimePeriod  <String>
  -TimePeriodFrom  <String>
  -TimePeriodTo  <String>
  -SessionQualities  <String[]>
  -DurationFrom  <Int32>
  -DurationTo  <Int32>
  -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[]>
  -Insights  <String[]>
  -TenantName  <String>
  -Scope  <String>
  -PageSize  <Int32>
  -ResultSize  <Int32>

Examples

Example 1

Get-NectarModalityQualitySummary -Modality AUDIO -TimePeriod LAST_DAY

Returns the modality quality summary for the past day

Parameters

-Modality <String>
Show sessions that match one or more modality types. Not case sensitive. Choose one or more from:
'AUDIO','VIDEO','APPSHARING'

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

-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 2
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 3
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 4
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 5
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 6
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 7
Required false
Default Value 99999999
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 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

-Insights <String[]>
Show sessions that match one or more given insights. Choose from NORMAL_SESSION, VOICE_MAIL, HIGH_JITTER, HIGH_PACKET_LOSS, HIGH_ROUNDTRIP_DELAY

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

-Scope <String>

Parameter Value
Required false
Position 65
Required false
Default Value DEFAULT
Accept pipeline input? false
Accept wildcard characters? false

-PageSize <Int32>
The size of the page used to return data. Defaults to 1000

Parameter Value
Required false
Position 66
Required false
Default Value 1000
Accept pipeline input? false
Accept wildcard characters? false

-ResultSize <Int32>
The total number of results to return. Defaults to 1000. Maximum result size is 9,999,999 results

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