Set-CsThirdPartyVideoSystem
Modifies an existing Active Directory contact object that represents a third-party video system. A third-party video system is a video teleconferencing device (VTC) that provides users with telepresence: the ability to participate in online meetings and conferences with full audio and video capabilities.
Syntax
Set-CsThirdPartyVideoSystem
[-Identity] <UserIdParameter>
[-Confirm]
[-DisplayName <String>]
[-Enabled <Boolean>]
[-ExchangeArchivingPolicy <ExchangeArchivingPolicyOptionsEnum>]
[-LineURI <String>]
[-PassThru]
[-SipAddress <String>]
[-WhatIf]
[<CommonParameters>] Description
Third-party video systems are VTC devices that provide remote users with telepresence capabilities (most notably audio and video).
In Skype for Business Server, third-party VTC devices can be configured as Active Directory contact objects, much in the same way that analog phones and common area phones can be configured as contact objects.
Associating each VTC device with a contact object makes it easy for administrators to track, and to manage, these devices.
VTC contact objects can be created by using the New-CsThirdPartyVideoSystem cmdlet.
If you later need to modify the property values for one of these contact objects you can do so by using the Set-CsThirdPartyVideoSystem cmdlet.
Examples
-------------------------- Example 1 --------------------------
Get-CsThirdPartyVideoSystem -Filter {DisplayName -eq "Redmond Video System" | Set-CsThirdPartyVideoSystem -SipAddress "sip:redmondvideo$litwareinc.com"The command shown in Example 1 changes the SIP address for the third-party video system with the Active Directory display name Redmond Video System.
To carry out this task, the command first uses the Get-CsThirdPartyVideoSystem cmdlet and the Filter parameter to return the video system that has the Active Directory display name Redmond Video System.
The contact object for that system is then piped to the Set-CsThirdPartyVideoSystem cmdlet, which changes the object's SIP address to sip:redmondvideo@litwareinc.com.
-------------------------- Example 2 --------------------------
Get-CsThirdPartyVideoSystem | Set-CsThirdPartyVideoSystem -Enabled $FalseIn Example 2, all the third-party video systems configured for use in the organization are disabled.
In order to do this, the command first uses the Get-CsThirdPartyVideoSystem cmdlet (without any parameters) to return a collection of all the available video systems.
That collection is then piped to the Set-CsThirdPartyVideoSystem cmdlet, which disables each system by setting the Enabled property to False ($False).
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 |
-DisplayName
Configures the Active Directory display name of the video system.
| 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 |
-Enabled
When set to True ($True) the video system can be used with Skype for Business Server.
| Type: | Boolean |
| Aliases: | CsEnabled |
| 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 |
-ExchangeArchivingPolicy
Indicates where the contact's instant messaging sessions are archived. Allowed values are:
Uninitialized
UseLyncArchivingPolicy
NoArchiving
ArchivingToExchange
| Type: | ExchangeArchivingPolicyOptionsEnum |
| 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 system being modified.
Video systems are identified by using the Active Directory distinguished name (DN) of the associated contact object.
By default, video systems use a GUID (globally unique identifier) as their common name, which means systems will typically have an Identity similar to this: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.
In turn, that means that you might find it easier to modify third-party video systems by using the Get-CsThirdPartyVideoSystem cmdlet to return the devices and then piping those objects to the Set-CsThirdPartyVideoSystem cmdlet.
| Type: | UserIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
-LineURI
Phone number for the analog device. The line URI should be specified by using the E.164 format, and should be prefixed by the "TEL:" prefix. For example:
-LineURI "TEL:+14255551297"
Any extension number should be added to the end of the line URI; for example:
-LineURI "TEL:+14255551297;ext=51297"
| 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 |
-PassThru
Enables you to pass a contact object through the pipeline that represents the third-party video system being modified.
By default, the Set-CsThirdPartyVideoSystem cmdlet does not pass objects through the pipeline.
| 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 |
-SipAddress
Unique identifier that allows the video system to communicate with SIP devices such as Skype for Business. The SIP address must be prefaced by the prefix "sip:". For example:
sip:redmondvideo@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 |
-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-CsThirdPartyVideoSystem cmdlet accepts pipelined instances of the Microsoft.Rtc.Management.ADConnect.Schema.OCSADThirdPartyVideoSystemContact object.
Outputs
By default, the Set-CsThirdPartyVideoSystem cmdlet does not return any data or objects.
However, if you include the PassThru parameter the cmdlet will pass instances of the Microsoft.Rtc.Management.ADConnect.Schema.OCSADThirdPartyVideoSystemContact object through the pipeline.