Export (0) Print
Expand All
Collapse the table of content
Expand the table of content
Expand Minimize



Topic Last Modified: 2012-03-26

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.

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>]]

This cmdlet creates a new collection of settings that define behaviors for specific media actions.

Who can run this cmdlet: By default, members of the following groups are authorized to run the New-CsMediaConfiguration cmdlet locally: RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsMediaConfiguration"}


Parameter Required Type Description




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 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 only for the A/V Conferencing service, Mediation Server, and Application Server.




QoS monitors the quality of voice signals over a network.

Default: False




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

Default: False




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




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




Suppresses any confirmation prompts that would otherwise be displayed before making changes.




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.




Describes what would happen if you executed the command without actually executing the command.




Prompts you for confirmation before executing the command.

Creates an object of type Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

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

New-CsMediaConfiguration -Identity site:Redmond1 -EncryptionLevel RequireEncryption

Example 1 uses New-CsMediaConfiguration 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 -EnableSiren $True

This example uses New-CsMediaConfiguration to create a new media configuration with the Identity This new configuration will have an EnableSiren value of True, which means that Siren is enabled for calls involving this Mediation Server.

© 2016 Microsoft