See Also
Topic Last Modified: 2011-04-12
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. 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. |
|
EnableQoS |
Optional |
Boolean |
QoS monitors the quality of voice signals over a network. Default: False |
|
EnableSiren |
Optional |
Boolean |
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 |
|
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 case sensitive; values will be converted to appropriate casing when the configuration is created. Default: VGA600K |
|
Force |
Optional |
SwitchParameter |
Suppresses any confirmation prompts that would otherwise be displayed before making changes. |
|
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. |
|
WhatIf |
Optional |
SwitchParameter |
Describes what would happen if you executed the command without actually executing the command. |
|
Confirm |
Optional |
SwitchParameter |
Prompts you for confirmation before executing the command. |
Detailed Description
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"}
Input Types
None.
Return Types
Creates an object of type Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.
Example
-------------------------- Example 1 --------------------------
 Copy Code |
|
|---|---|
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 --------------------------
| Copy Code |
|
|---|---|
New-CsMediaConfiguration -Identity MediationServer:pool0.litwareinc.com -EnableSiren $True |
|
This example uses New-CsMediaConfiguration 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.