Remove-CsVideoTrunkConfiguration
Use the Remove-CsVideoTrunkConfiguration to remove one or more Video Trunk configurations.
Video Trunk configuration settings are scoped to Video Gateway instances and govern the behavior of the Session Initiation Protocol (SIP) trunk between each Video Gateway instance and the paired Video Interop Server instance that together define the Video Trunk.
Syntax
Default (Default)
Remove-CsVideoTrunkConfiguration
[-Identity] <XdsIdentity>
[-Confirm]
[-Force]
[-WhatIf]
[<CommonParameters>]
Description
The Video Interop Server (VIS) in Skype for Business Server incorporates 3rd party video teleconferencing systems (VTCs) into your Skype for Business Server 2015 infrastructure. The VIS is a service that runs on a standalone pool and cannot be co-located on an FE pool.
To enable the Video Interop Server, you must use Topology Builder to define at least one VIS instance. Each VIS instance will typically be associated with one or more Video Gateways. Video Gateways route traffic between internal and third party video devices such as an internal Skype endpoint receiving video from a third party PBX supporting 3rd party video teleconferencing systems (VTCs). The Video Gateway and a Video Interop Server (VIS) use a Session Initiation Protocol (SIP) trunk to connect video calls between third party VTCs and internal endpoints.
Video Trunks settings can be managed by using the CsVideoTrunkConfiguration cmdlets. These settings are used to manage the following Video Trunk characteristics.
RTCP for active calls
RTCP for calls on hold
Secure Real-time Transport Protocol (SRTP) use when Transport Layer Security (TLS) is used for the SIP signaling
Session timers usage on the Video Interop Server (VIS) for dialogs associated with a Video Trunk
By default, Skype for Business Server ships with a single, global collection of Video Trunk configuration settings.
However, administrators can use the New-CsVideoTrunkConfiguration cmdlet to create additional settings at the site or the service scope (for the Video Gateway service only).
Examples
Example 1
Remove-CsVideoTrunkConfiguration -Identity "site:Seattle"
This example removes the Video Trunk configuration settings scoped to the Seattle site.
Example 2
Get-CsVideoTrunkConfiguration -Filter "site:*" | Remove-CsVideoTrunkConfiguration
This example removes all the configuration settings that have been scoped at the site level.
The command first calls the Get-CsVideoTrunkConfiguration cmdlet along with the Filter parameter that limits the returns to configurations scoped at the site level.
Those configuration objects are then piped to, and removed by, the Remove-CsVideoTrunkConfiguration cmdlet.
Parameters
-Confirm
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
Prompts you for confirmation before executing the command.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Force
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
Suppresses the display of any non-fatal error messages and completes the cmdlet operation.
Parameter properties
| Type: | SwitchParameter |
| 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 |
-Identity
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
The Identity parameter specifies the Video Trunk configuration to remove.
Video Trunk configuration settings can be configured at the global, site, or service scope (for the VideoGateway service only).
To refer to the global instance, use this syntax: -Identity "global" To refer to a collection at the site scope: -Identity "site:Redmond"
Wildcard characters such as the asterisk (*) cannot be used with the Identity parameter.
The Remove-CsVideoTrunkConfiguration cmdlet can be run against the single global collection of settings.
However, that single global collection will not be deleted.
Instead, all the properties within the collection will be reset to their default values.
Parameter properties
| Type: | XdsIdentity |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-WhatIf
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
Describes what would happen if you executed the command without actually executing the command.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
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
Microsoft.Rtc.Management.WritableConfig.Settings.VideoTrunkConfiguration
The Remove-CsVideoTrunkConfiguration cmdlet accepts pipelined input of the Microsoft.Rtc.Management.WritableConfig.Settings.VideoTrunkConfiguration object.
Outputs
None
The Remove-CsVideoTrunkConfiguration cmdlet removes specified Microsoft.Rtc.Management.WritableConfig.Settings.VideoTrunkConfiguration objects.