Muokkaa

Jaa

Set-CsThirdPartyVideoSystemPolicy

  • Reference
Module:
SkypeForBusiness
Applies to:
Skype for Business Server 2015, Skype for Business Server 2019

Creates a new third-party video system policy for use with video teleconferencing (VTC) devices. These policies determine whether or not the VTC is allowed to send low-resolution video.

Syntax

Set-CsThirdPartyVideoSystemPolicy
   [[-Identity] <XdsIdentity>]
   [-Confirm]
   [-Force]
   [-SupportsSendingLowResolution <Boolean>]
   [-Tenant <Guid>]
   [-WhatIf]
   [<CommonParameters>]
Set-CsThirdPartyVideoSystemPolicy
   [-Confirm]
   [-Force]
   [-Instance <PSObject>]
   [-SupportsSendingLowResolution <Boolean>]
   [-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 disable 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 New-CsThirdPartyVideoSystem cmdlet provides a way for administrators to create these third-party video system policies. Both the global policy and any custom policies you create can later be modified by using the Set-CsThirdPartyVideoSystemPolicy cmdlet.

Examples

-------------------------- Example 1 --------------------------

Set-CsThirdPartyVideoSystemPolicy -Identity "RedmondVideoSystemPolicy" -SupportsSendingLowResolution $False

The command shown in Example 1 modifies the per-user third-party video system policy RedmondVideoSystemPolicy. In this example, the ability to send low-resolution video is disabled.

-------------------------- Example 2 --------------------------

Get-CsThirdPartyVideoSystemPolicy -Filter "site:*" | Set-CsThirdPartyVideoSystemPolicy -SupportsSendingLowResolution $False

In Example 2, the ability to send low-resolution video is disabled for all third-party video system policies configured at the site scope. To do that, the command first calls Get-CsThirdPartyVideoSystemPolicy along with the Filter parameter; the filter value "site:*" limits returned data to policies configured at the site scope. That collection of site-based policies is then piped to the Set-CsThirdPartyVideoSystemPolicy to set the SupportsSendingLowResolution 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

-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 created at the global, site or per-user scope. To refer to the global instance, use this syntax:

-Identity "global"

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. If this parameter is not specified then Set-CsThirdPartyVideoSystemPolicy will modify the global video system policy.

Type:XdsIdentity
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

-Instance

Allows you to pass a reference to an object to the cmdlet rather than set individual parameter values.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-SupportsSendingLowResolution

Indicates whether or not low-resolution video can be used in conjunction with a VTC device. The default value is True ($True).

Type:Boolean
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

-Tenant

Globally unique identifier (GUID) of the Skype for Business Online tenant account for the third-party video system policy being modified. 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 Set-CsThirdPartyVideoSystemPolicy cmdlet accepts pipelined instance of the Microsoft.Rtc.Management.WritableConfig.Policy.ThirdPartyVideoSystem.ThirdPartyVideoSystemPolicy object.

Outputs

None. Instead, the Set-CsThirdPartyVideoSystemPolicy cmdlet modifies existing instances of the Microsoft.Rtc.Management.WritableConfig.Policy.ThirdPartyVideoSystem.ThirdPartyVideoSystemPolicy object.