Set-CsMediaConfiguration

Modifies an existing collection of media settings. This cmdlet was introduced in Lync Server 2010.

Syntax

Set-CsMediaConfiguration
   [[-Identity] <XdsIdentity>]
   [-EnableQoS <Boolean>]
   [-EnableSiren <Boolean>]
   [-EncryptionLevel <EncryptionLevel>]
   [-MaxVideoRateAllowed <MaxVideoRateAllowed>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [-EnableAdaptiveBandWidthEstimation <Boolean>]
   [-EnableG722StereoCodec <Boolean>]
   [-EnableH264Codec <Boolean>]
   [-EnableInCallQoS <Boolean>]
   [-EnableRtpRtcpMultiplexing <Boolean>]
   [-InCallQoSIntervalSeconds <UInt16>]
   [-EnableVideoBasedSharing <Boolean>]
   [-EnableDtls <Boolean>]
   [-EnableSilkForAudioVideoConferences <Boolean>]
   -[EnableServerFecForVideoInterop]
   [-WaitIceCompletedToAddDialOutUser]
   [-EnableRtx <Boolean>]
   [-EnableAVBundling <Boolean>]
   [-EnableReceiveAgc <Boolean>] 
   [<CommonParameters>]
Set-CsMediaConfiguration
   [-Instance <PSObject>]
   [-EnableQoS <Boolean>]
   [-EnableSiren <Boolean>]
   [-EncryptionLevel <EncryptionLevel>]
   [-MaxVideoRateAllowed <MaxVideoRateAllowed>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [-EnableAdaptiveBandWidthEstimation <Boolean>]
   [-EnableG722StereoCodec <Boolean>]
   [-EnableH264Codec <Boolean>]
   [-EnableInCallQoS <Boolean>]
   [-EnableRtpRtcpMultiplexing <Boolean>]
   [-InCallQoSIntervalSeconds <UInt16>]
   [-EnableVideoBasedSharing <Boolean>]
   [-EnableDtls <Boolean>]
   [-EnableSilkForAudioVideoConferences <Boolean>]
   -[EnableServerFecForVideoInterop]
   [-WaitIceCompletedToAddDialOutUser]
   [-EnableRtx <Boolean>]
   [-EnableAVBundling <Boolean>]
   [-EnableReceiveAgc <Boolean>] 
   [<CommonParameters>]

Description

This cmdlet modifies a collection of settings that define media configuration. These actions relate to audio and video calls between client endpoints.

Examples

Example 1

Set-CsMediaConfiguration -Identity site:Redmond1 -MaxVideoRateAllowed hd720p15m

Example 1 modifies the media configuration collection with the Identity site:Redmond1; in particular, the command sets the value of the MaxVideoRateAllowed property to Hd720p15M. Note that the value passed to the MaxVideoRateAllowed parameter must be one of the values specified in the parameter description. Also note that the values are not case sensitive; the value entered here as hd720p15m will be automatically converted to the appropriate casing (in this instance, to Hd720p15M).

Example 2

Set-CsMediaConfiguration site:Redmond1 -EncryptionLevel donotsupportencryption

This example modifies the media configuration collection with the Identity site:Redmond1 to have an EncryptionLevel value of DoNotSupportEncryption. Note that this value is not case sensitive; the value was entered as donotsupportencryption, but that value will be accepted as a valid value and will be automatically changed to mixed case (DoNotSupportEncryption).

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:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-EnableAdaptiveBandWidthEstimation

When set to True (the default value) Microsoft Lync Server will select the bandwidth rate at which to play a video stream. This selection will be based on such factors as the network congestion and the client's quality of the client's current network connection. This parameter was removed starting Lync Server Cumulative Update 3.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013

-EnableAVBundling

This parameter is reserved for internal Microsoft use.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableDtls

Enables the use of Datagram Transport Layer Security (DTLS) for ICE

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

-EnableG722StereoCodec

When set to True (the default value) allows the use of the G.722 wideband speech codec. G.722 is a standard voice codec commonly used with Voice over IP applications; with a sampling rate of 16 KHz G.722 provides higher voice quality and clarity than many other commonly-used speech codecs.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013

-EnableH264Codec

When set to True (the default value) allows the use of the H.264/MPEG-4 AVC video codec. H.264 is a standard codec commonly used for recording, compressing and distributing high-definition video.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013

-EnableInCallQoS

Enables or disables the ability of Skype for Business clients to send the raw data that's required to generate InCallQuality messages.

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

-EnableQoS

QoS monitors the quality of voice signals over a network. When set to True, enables call Quality of Service (QoS) settings.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-EnableReceiveAgc

This parameter is reserved for internal Microsoft use.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableRtpRtcpMultiplexing

Enables or disables the use of RTP/RTCP Multiplexing, if enabled, when negotiating, only one candidate will be used for both RTP and RTCP.

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

-EnableRtx

This parameter is reserved for internal Microsoft use.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableServerFecForVideoInterop

Enables the use of server Forward Error Correction for video interoperability

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

-EnableSilkForAudioVideoConferences

Enables the use of SILK codec for A/V conferences

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

-EnableSiren

By default, the Mediation Server does not negotiate Siren as a possible codec for calls between itself and other clients. If this setting is True, Siren will be included as a possible codec for use between the Mediation Server and other clients.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-EnableVideoBasedSharing

Enables the use of Video Based Sharing, for more information, see Video based Screen Sharing for Skype for Business Server

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

-EncryptionLevel

The level of encryption between unified communications devices.

Valid values:

SupportEncryption - secure real-time transport protocol (SRTP) will be used if it can be negotiated.

RequireEncryption - SRTP must be negotiated.

DoNotSupportEncryption - SRTP must not be used.

This value is not case sensitive. (For details, see the Examples in this topic.)

Default: RequireEncryption

Type:EncryptionLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, 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:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-Identity

The unique identifier of the media configuration settings you want to change. This identifier specifies the scope at which this configuration is applied (global, site, or service).

Type:XdsIdentity
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-InCallQoSIntervalSeconds

Specifies the interval between call QoS actions.

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

-Instance

An instance of the Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings object. You can retrieve this object by calling the Get-CsMediaConfiguration cmdlet with a specific Identity. You can then assign new values to the properties of that object and then save those changes by passing the object to the Set-CsMediaConfiguration cmdlet.

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

-MaxVideoRateAllowed

The maximum rate at which video signals will be transferred at the client endpoints.

Valid values: Hd720p15M, VGA600K, CIF250K

Hd720p15M - High definition, with a resolution of 1280 x 720 and aspect ratio 16:9.

VGA600K - VGA, with a resolution of 640 x 480, 25 fps with the aspect ratio 4:3.

CIF250K - Common Intermediate Format (CIF) video format, 15 fps with a resolution of 352 x 288.

Note that these values are not case sensitive; values will be converted to appropriate casing when the configuration is created. (For details, see the Examples in this topic.)

Default: VGA600K

Type:MaxVideoRateAllowed
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-WaitIceCompletedToAddDialOutUser

Waits until ICE negotiation is complete to dial out other people

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

Inputs

Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings object. Accepts pipelined input of media configuration objects.

Outputs

The Set-CsMediaConfiguration cmdlet does not return a value or object. Instead, the cmdlet configures instances of the Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings object.