Edit

Get-CsVideoTrunk

  • Reference
Module:
SkypeForBusiness
Applies to:
Skype for Business Server 2015, Skype for Business Server 2019

Use the Get-CsVideoTrunk to list properties about the video trunks in your organization. Video trunks are Session Initiation Protocol (SIP) trunks between the Video Interop Server and a Video Gateway that are used to setup video calls between 3rd party video teleconferencing systems (VTCs) connected to the Video Gateway and Skype conferences or Skype endpoints.

Syntax

Get-CsVideoTrunk
   [-Filter <String>]
   [-PoolFqdn <String>]
   [<CommonParameters>]
Get-CsVideoTrunk
   [[-Identity] <XdsGlobalRelativeIdentity>]
   [-PoolFqdn <String>]
   [<CommonParameters>]

Description

Video trunks are SIP trunks between the Video Interop Server and a Video Gateway that are used to setup video calls between 3rd party video teleconferencing systems (VTCs) connected to the Video Gateway and Skype conferences or Skype endpoints.

Trunk information is read-only. You cannot create, delete or modify trunks by using Windows PowerShell. Those operations can only be carried out by using Skype for Business Server Topology Builder.

To return a list of all the role-based access control (RBAC) roles that can run this cmdlet (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt.

Get-CsAdminRole | Where-Object {$_.Cmdlets -Match "Get-CsVideoTrunk"}

Examples

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

Get-CsVideoTrunk

This example returns information about all the video trunks configured for use in the organization.

-------------------------- Example 2 --------------------------

Get-CsVideoTrunk -Identity "VideoTrunk:192.168.0.240"

This example returns information for a single video trunk with the identity "VideoTrunk:192.168.0.240".

-------------------------- Example 3 --------------------------

Get-CsVideoTrunk -Filter "VideoTrunk:192.168*"

This example uses the Filter parameter to return all the video trunks located on the IP subnet 192.168. The filter value "VideoTrunk:192.168*" limits the returned data to video trunks that having an Identity that begins with the string value "192.168".

Parameters

-Filter

Enables you to use wildcard characters in order to return a video trunk (or a collection of video trunks).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-Identity

Unique identifier for the video trunk to be returned. For example:

-Identity "VideoTrunk:192.168.0.240"

You cannot use wildcards when specifying an Identity. Use the Filter parameter instead.

If this parameter is not specified, then all the video trunks in the organization are returned.

Type:XdsGlobalRelativeIdentity
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-PoolFqdn

Fully qualified domain name of the trunk as defined in the topology. For example:

-PoolFqdn "atl-trunk-001.litwareinc.com"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

Inputs

None. The Get-CsVideoTrunk cmdlet does not accept pipelined input.

Outputs

The Get-CsVideoTrunk cmdlet returns instances of the Microsoft.Rtc.Management.Xds.DisplayVideoGateway#Decorated object.