New-CsMediaConfiguration
上一次修改主题: 2012-03-26
创建新的媒体设置集合。这些设置可用于指定诸如支持的加密级别和允许的最大视频分辨率等信息。
语法
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>]]
详细说明
此 cmdlet 会创建一个新的设置集合,用于定义特定媒体操作的行为。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 New-CsMediaConfiguration cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsMediaConfiguration"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
Xds 标识 |
用于指定配置的应用范围(站点或服务)的唯一标识符。输入站点范围内的配置时将采用 site:<site name> 的形式,如 site:Redmond。输入服务时将采用 <服务器角色>:<fqdn> 的形式,如 MediationServer:pool0.litwareinc.com。global 作用域的媒体配置将始终存在并且无法删除,因此无法创建新的全局配置。 只能为 A/V 会议服务、中介服务器和应用程序服务器创建在 Service 作用域创建的媒体配置。 |
EnableQoS |
可选 |
布尔值 |
QoS 将监控网络中的语音信号质量。 默认值:False |
EnableSiren |
可选 |
布尔值 |
默认情况下,中介服务器不会在自身与其他 Microsoft Lync 2010 客户端之间协商 Siren。如果此设置为 True,则会包括 Siren 作为可供在中介服务器与其他Lync 2010客户端之间使用的编解码器。 默认值:False |
EncryptionLevel |
可选 |
EncryptionLevel |
统一通信实体之间的加密级别。 有效值: SupportEncryption - 如果可以协商,则将使用安全实时传输协议 (SRTP)。 RequireEncryption - 必须协商 SRTP。 DoNotSupportEncryption - 不得使用 SRTP。 默认值:RequireEncryption |
MaxVideoRateAllowed |
可选 |
MaxVideoRateAllowed |
客户端终结点允许的最大视频信号传输速率。 有效值:Hd720p15M、VGA600K、CIF250K Hd720p15M - 高清晰度,分辨率为 1280 x 720,纵横比为 16:9。 VGA600K - VGA,分辨率为 640 x 480,每秒帧数为 25,纵横比为 4:3。 CIF250K - 通用中间格式 (CIF) 视频格式,每秒帧数为 15,分辨率为 352 x 288。 请注意,这些值不区分大小写;创建配置后,值将转换为相应的大小写形式。 默认值:VGA600K |
Force |
可选 |
开关参数 |
禁止显示任何本该在进行更改前显示的确认提示。 |
InMemory |
可选 |
开关参数 |
创建对象引用,但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量,您可以更改对象引用的属性,然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
创建一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings 的对象。
示例
-------------------------- 示例 1 --------------------------
New-CsMediaConfiguration -Identity site:Redmond1 -EncryptionLevel RequireEncryption
示例 1 使用 New-CsMediaConfiguration 新建一个 Identity 为 site:Redmond1 的媒体配置。该新配置要求加入多媒体对话的双方使用加密。这一要求是通过添加 EncryptionLevel 参数并将参数值设置为 RequireEncryption 来实现的。
-------------------------- 示例 2 --------------------------
New-CsMediaConfiguration -Identity MediationServer:pool0.litwareinc.com -EnableSiren $True
此示例使用 New-CsMediaConfiguration 新建一个 Identity 为 MediationServer:pool0.litwareinc.com 的媒体配置。此新配置的 EnableSiren 值将为 True,这意味着涉及此中介服务器的呼叫将启用 Siren。