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.
Syntax
New-CsMediaConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableQoS <$true | $false>] [-EnableSiren <$true | $false>] [-EncryptionLevel <SupportEncryption | RequireEncryption | DoNotSupportEncryption>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxVideoRateAllowed <CIF250K | VGA600K | Hd720p15M>] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
XdsIdentity |
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. |
|
EnableQoS |
Optional |
Boolean |
This parameter enables or disables Quality of Service (QoS) marking on Mediation Server. QoS monitors the quality of voice signals over a network. Setting this parameter to True causes Mediation Server to perform Differentiated Services Code Point (DSCP) marking on voice packets. This helps to provide a QoS guarantee on IP networks. However, in a network that has been properly provisioned for voice transmission, this is not necessary. But if you are unsure of bandwidth capacity, setting this parameter to True assures good voice quality even in suboptimal environments. Default: False |
|
EnableSiren |
Optional |
Boolean |
By default, the Mediation Server does not negotiate Siren between itself and other Unified Communications endpoints. If this setting is True, Siren will be included as a possible codec for use between the Mediation Server and other Unified Communications endpoints. Default: False |
|
EncryptionLevel |
Optional |
EncryptionLevel |
The level of encryption between Unified Communications entities. 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 |
|
MaxVideoRateAllowed |
Optional |
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 casesensitive; values will be converted to appropriate casing when the configuration is created. Default: VGA600K |
|
InMemory |
Optional |
SwitchParameter |
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. |
|
Confirm |
Optional |
SwitchParameter |
Prompts you for confirmation before executing the command. |
|
Force |
Optional |
SwitchParameter |
Suppresses any confirmation prompts that would otherwise be displayed before making changes. |
|
WhatIf |
Optional |
SwitchParameter |
Describes what would happen if you executed the command without actually executing the command. |
Detailed Description
This cmdlet creates a new collection of settings that define behaviors for specific media actions.
Available scope: Global, Site, Service. Service is available only for Conferencing Service, Mediation Server, and Application Server.
Return Types
Creates an object of type Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.
Examples
-------------------------- Example 1 --------------------------
 Copy Code |
|
|---|---|
New-CsMediaConfiguration -Identity site:Redmond1 -EncryptionLevel RequireEncryption |
|
Example 1 uses New-CsMediaConfiguration to create a new media configuration collection with the Identity site:Redmond1. This new collection 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 --------------------------
| Copy Code |
|
|---|---|
New-CsMediaConfiguration -Identity MediationServer:pool0.litwareinc.com -EnableSiren $True |
|
This example uses New-CsMediaConfiguration to create a new media configuration collection 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.