Edit

Share via

Get-CsVideoTrunk

Module:
Skype for Business Server PowerShell

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

Filter 

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

Identity 

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

Applicable: Skype for Business Server 2015, Skype for Business Server 2019

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Filter
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Identity

Applicable: Skype for Business Server 2015, Skype for Business Server 2019

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.

Parameter properties

Type:XdsGlobalRelativeIdentity
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Identity
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PoolFqdn

Applicable: Skype for Business Server 2015, Skype for Business Server 2019

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

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

The Get-CsVideoTrunk cmdlet does not accept pipelined input.

Outputs

Microsoft.Rtc.Management.Xds.DisplayVideoGateway

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