New-CsMediaConfiguration
Creates a new collection of media settings. These settings can be used to specify such things as the supported level of encryption and the maximum allowed video resolution. This cmdlet was introduced in Lync Server 2010.
Syntax
Default (Default)
New-CsMediaConfiguration
[-Identity] <XdsIdentity>
[-EnableQoS <Boolean>]
[-EnableSiren <Boolean>]
[-EncryptionLevel <EncryptionLevel>]
[-MaxVideoRateAllowed <MaxVideoRateAllowed>]
[-Force]
[-InMemory]
[-WhatIf]
[-Confirm]
[-EnableAdaptiveBandWidthEstimation <Boolean>]
[-EnableG722StereoCodec <Boolean>]
[-EnableH264Codec <Boolean>]
[-EnableInCallQoS <Boolean>]
[-EnableRtpRtcpMultiplexing <Boolean>]
[-InCallQoSIntervalSeconds <UInt16>]
[-EnableVideoBasedSharing <Boolean>]
[<CommonParameters>]
Description
This cmdlet creates a new collection of settings that define the behavior of specific media actions.
Examples
EXAMPLE 1
New-CsMediaConfiguration -Identity site:Redmond1 -EncryptionLevel RequireEncryption
Example 1 uses the New-CsMediaConfiguration cmdlet to create a new media configuration with the Identity site:Redmond1. This new configuration requires both parties involved in a multimedia conversation to use encryption. That requirement is put in place by adding the EncryptionLevel parameter and setting the parameter value to RequireEncryption.
EXAMPLE 2
New-CsMediaConfiguration -Identity MediationServer:pool0.litwareinc.com -EnableSiren $True
This example uses the New-CsMediaConfiguration cmdlet to create a new media configuration with the Identity MediationServer:pool0.litwareinc.com. This new configuration will have an EnableSiren value of True, which means that Siren is enabled for calls involving this Mediation Server.
Parameters
-Confirm
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Prompts you for confirmation before executing the command.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableAdaptiveBandWidthEstimation
Applicable: Lync Server 2013
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.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableG722StereoCodec
Applicable: Lync Server 2013
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.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableH264Codec
Applicable: Lync Server 2013
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.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableInCallQoS
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
Enables or disables the ability of Skype for Business clients to send the raw data that's required to generate InCallQuality messages.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableQoS
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
QoS monitors the quality of voice signals over a network. When set to True, enables call Quality of Service (QoS) settings.
Parameter properties
| Type: | Boolean |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableRtpRtcpMultiplexing
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
Enables or disables the use of RTP/RTCP Multiplexing, if enabled, when negotiating, only one candidate will be used for both RTP and RTCP.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableSiren
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
By default, the Mediation Server does not negotiate Siren as a possible codec for calls between itself and clients. If this setting is True, Siren will be included as a possible codec for use between the Mediation Server and other clients.
Default: False
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableVideoBasedSharing
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
Enables the use of Video Based Sharing, for more information, see Video based Screen Sharing for Skype for Business Server
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EncryptionLevel
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
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.
Default: RequireEncryption
Parameter properties
| Type: | EncryptionLevel |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Force
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Suppresses any confirmation prompts that would otherwise be displayed before making changes.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Identity
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
A unique identifier specifying the scope at which this configuration is applied (site or service). A configuration at the site scope would be entered as site:<site name>, such as site:Redmond. A service would be entered as <server role>:<fqdn>, such as MediationServer:pool0.litwareinc.com. A media configuration at the global scope will always exist and cannot be removed, so a new global configuration cannot be created.
Media configurations created at the service scope can be created for only the A/V Conferencing service, Mediation Server, and Application Server.
Parameter properties
| Type: | XdsIdentity |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-InCallQoSIntervalSeconds
Applicable: Skype for Business Server 2015, Skype for Business Server 2019
Specifies the interval between call QoS actions.
Parameter properties
| Type: | UInt16 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-InMemory
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet's matching Set-<cmdlet>.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-MaxVideoRateAllowed
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
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.
Default: VGA600K
Parameter properties
| Type: | MaxVideoRateAllowed |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
Describes what would happen if you executed the command without actually executing the command.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
None
Outputs
Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings
Creates an object of type Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.