Remove-CsThirdPartyVideoSystemPolicy
Removes a third-party video system policy. Video system policies determine whether or not a VTC (video teleconferencing) device is allowed to send low-resolution video.
Syntax
Remove-CsThirdPartyVideoSystemPolicy
[-Identity] <XdsIdentity>
[-Confirm]
[-Force]
[-Tenant <Guid>]
[-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.
One key management task related to VTC devices is to enable (or disable) the ability of these devices to send low-resolution video.
By default, VTC devices are allowed to send low-resolution video.
However, administrators can create third-party video system policies that prevent the use of low-resolution video.
This might be useful for devices located in conference rooms or other areas where low-resolution video is not considered acceptable.
The Remove-CsThirdPartyVideoSystem cmdlet provides a way for administrators to remove any third-party video system policies that have been created at the site or the per-user scope.
When a site policy is deleted, VTC devices that were previously managed by that policy will fall under the jurisdiction of the global policy.
When a per-user policy is deleted, VTC devices previously managed by that policy will be managed by their site policy.
If the device site does not have a site policy then those devices will be managed by using the global policy.
Note that this cmdlet can also be run against the global third-party video system policy. However, the cmdlet will not actually delete the global policy; Skype for Business Server does not allow global policies to be deleted. Instead, the properties within the global policy will be reset to their default values. In this case, that means that the SupportsSendingLowResolution property will be set to True ($True).
Examples
-------------------------- Example 1 --------------------------
Remove-CsThirdPartyVideoSystemPolicy -Identity "RedmondVideoSystemPolicyThe command shown in Example 1 removes the per-user third-party video system policy with the Identity RedmondVideoSystemPolicy.
-------------------------- Example 2 --------------------------
Get-CsThirdPartyVideoSystemPolicy | Remove-CsThirdPartyVideoSystemPolicyIn Example 2, all the third-party video system policies configured for use in the organization are deleted.
This is done by first using the Get-CsThirdPartyVideoSystemPolicy to return a collection of all the video system policies; that collection is then piped to and deleted by, the Remove-CsThirdPartyVideoSystemPolicy.
Note that the global policy will not actually be deleted; Skype for Business Server does not allow you to delete global policies.
However, all the properties within the global policy will be reset to their default values.
-------------------------- Example 3 --------------------------
Get-CsThirdPartyVideoSystemPolicy -Filter "site:*" | Remove-CsThirdPartyVideoSystemPolicyExample 3 deletes all the third-party video system policies configured at the site scope.
To do this, Get-CsThirdPartyVideoSystemPolicy is called along with the Filter parameter and the filter value "site:*"; this limits the returned data to policies configured at the site scope.
Those policies are then piped to the Remove-CsThirdPartyVideoSystemPolicy cmdlet, which deletes all the policies configured at the site scope.
Parameters
-Confirm
Describes what would happen if you executed the command without actually 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 any confirmation prompts that would otherwise be displayed before making changes.
| 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
Unique identity assigned to the policy when it was created. Third party video system policies can be assigned at the global, site, or per-user scope. To refer to the global instance, use this syntax:
-Identity "global"
Keep in mind that you cannot actually remove the global policy.
If you run Remove-CsThirdPartyVideoSystemPolicy against the global policy, the policy will not be deleted.
Instead, all the properties in the policy will be reset to their default values.
To refer to a policy at the site scope, use syntax similar to this:
-Identity "site:Redmond"
To refer to a policy at the per-user scope, use syntax similar to the following:
-Identity "RedmondVideoSystemPolicy"
Wildcard characters such as the asterisk (*) cannot be used with the Identity parameter.
| Type: | XdsIdentity |
| Position: | 2 |
| 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 |
-Tenant
Globally unique identifier (GUID) of the Skype for Business Online tenant account for the third party video system policy being removed. For example:
-Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"
You can return the tenant ID for each of your tenants by running this command:
Get-CsTenant | Select-Object DisplayName, TenantID
| Type: | Guid |
| 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 Remove-CsThirdPartyVideoSystemPolicy cmdlet accepts pipelined instances of the Microsoft.Rtc.Management.WritableConfig.Policy.ThirdPartyVideoSystem.ThirdPartyVideoSystemPolicy object
Outputs
None.
Instead, the Remove-CsThirdPartyVideoSystemPolicy cmdlet deletes instances of the Microsoft.Rtc.Management.WritableConfig.Policy.ThirdPartyVideoSystem.ThirdPartyVideoSystemPolicy object.
Related Links
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for