Set-CsVideoGateway
Use the Set-CsVideoGateway
cmdlet to modify the property values of one or more Video Gateways.
Video Gateways route traffic between internal and 3rd party video devices such as an internal Skype endpoint exchanging video with a 3rd 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 3rd party VTCs and internal endpoints.
Syntax
Set-CsVideoGateway
[[-Identity] <XdsGlobalRelativeIdentity>]
[-Confirm]
[-Force]
[-VideoGatewaySipClientTcpPort <UInt16>]
[-VideoGatewaySipClientTlsPort <UInt16>]
[-VideoInteropServer <String>]
[-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 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 3rd party video devices such as an internal Skype endpoint receiving video from a 3rd 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 3rd party VTCs and internal endpoints.
After a Video Gateway has been defined, you can then manage the properties of that gateway by using the Set-CsVideoGateway
cmdlet.
Examples
-------------------------- Example 1 --------------------------
Set-CsVideoGateway -Identity "VideoGateway:atl-cs-001.litwareinc.com" -VideoGatewaySipClientTcpPort 444
The command shown in Example 1 changes the TCP client port for the video gateway located on the pool atl-cs-001.litwareinc.com
.
In this example, the port is set to 444.
-------------------------- Example 2 --------------------------
Get-CsService -VideoGateway | Set-CsVideoGateway -VideoGatewaySipClientTcpPort 444
In Example 2, the TCP client ports for all the video gateways deployed in the organization are set to 444.
To do this, the command first uses the Get-CsService
cmdlet and the -VideoGateway parameter to return a collection of all the video gateways, That collection is then piped to the Set-CsVideoGateway
cmdlet, which sets the TCP client port for all the gateways in the collection to 444.
Parameters
-Confirm
Prompts you for confirmation before executing the command.
Type: | SwitchParameter |
Aliases: | cf |
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 |
-Force
Suppresses the display of any non-fatal error message that might occur when running the command.
Type: | SwitchParameter |
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
Service location of the video gateway being modified. For example:
-Identity "VideoGateway:atl-cs-001.litwareinc.com"
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 |
-VideoGatewaySipClientTcpPort
TCP (Transmission Control Protocol) listening port on the Video Gateway used for SIP trunk communication with a Video Interop Server pool.
Type: | UInt16 |
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 |
-VideoGatewaySipClientTlsPort
TLS (Transport Layer Security) listening port on the Video Gateway used for SIP trunk communication with a Video Interop Server pool.
Type: | UInt16 |
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 |
-VideoInteropServer
Service location for the Video Interop Server associated with this Video Gateway.
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 |
-WhatIf
Describes what would happen if you executed the command without actually executing the command.
Type: | SwitchParameter |
Aliases: | wi |
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
The Set-CsVideoGateway
cmdlet accepts pipelined instances of the Microsoft.Rtc.Management.Xds.DisplayVideoGateway object.
Outputs
None.
The Set-CsVideoGateway
cmdlet does not return any objects or values.