Set-CsAVEdgeConfiguration
上一次修改主题： 2012-03-26
用于修改运行 A/V 边缘服务的计算机（这些计算机也称为 A/V 边缘服务器）的配置设置。通过 A/V 边缘服务器，内部用户可以与外部用户（即未登录内部网络的用户）共享音频和视频数据，还可以交换文件和参与桌面共享会话。
语法
Set-CsAVEdgeConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-MaxBandwidthPerPortKb <UInt32>] [-MaxBandwidthPerUserKb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]
Set-CsAVEdgeConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxBandwidthPerPortKb <UInt32>] [-MaxBandwidthPerUserKb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]
详细说明
A/V 边缘服务器提供了一种跨组织防火墙交换音频和视频通信的方法。此方法的功能之一是使用户可以通过 Internet 使用 Microsoft Lync Server 2010，然后与从防火墙内登录到系统的用户交换音频和视频数据。边缘服务器配置设置可以在 global 作用域、site 作用域和 service 作用域进行分配。通过这些配置设置，管理员可以执行管理用户身份验证在必须进行续订之前的有效期，以及限制单个用户或单个端口可以使用的带宽量等操作。
Set-CsAVEdgeConfiguration cmdlet 提供了一种修改组织中当前正在使用的 A/V 边缘配置设置的方法。但是，除非有 Microsoft 支持人员的指导，否则建议管理员不要修改默认的 A/V 边缘设置。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsAVEdgeConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsAVEdgeConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要修改的 A/V 边缘配置设置集合的唯一标识符。要修改全局集合，请使用以下语法：-Identity global。要修改站点集合，请使用类似如下的语法：-Identity site:Redmond。应使用类似如下的语法引用在 service 作用域配置的设置：-Identity service:EdgeServer:atl-cs-001.litwareinc.com。 |
Instance |
可选 |
媒体中继设置对象 |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
MaxBandwidthPerPortKB |
可选 |
整数 |
指示可以分配给单个端口的最大带宽（以 kbps 为单位）。最大带宽可以设置为每秒 1 到 4294967296 (4096 Gb) 之间的任意整数值，默认值是 3000。 |
MaxBandwidthPerUserKB |
可选 |
整数 |
指示可以分配给任何一个用户的最大带宽（以 kbps 为单位）。最大带宽可以设置为每秒 1 到 4294967296 (4096 Gb) 之间的任意整数值，默认值是 10000。 |
MaxTokenLifetime |
可选 |
TimeSpan |
身份验证令牌在过期并必须进行续订之前，可以使用的最长时间。使用以下格式表示令牌生存期：Days.Hours:Minutes:Seconds。例如，必须按如下格式表示 13 天，天数后跟句点 (.)，并使用冒号 (:) 分隔小时、分钟和秒： 13.00:00:00 默认值 8 小时必须按如下格式表示：08:00:00。 08:00:00 允许的令牌生存期最短为 1 分钟 (00:01:00)，最长为 180 天 (180.00:00:00)。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings 对象。Set-CsAVEdgeConfiguration 接受通过管道传递的媒体中继设置对象的输入。
返回类型
Set-CsAVEdgeConfiguration 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsAVEdgeConfiguration -Identity global -MaxTokenLifetime "04:00:00"
在示例 1 中，此命令修改全局 A/V 边缘配置设置的 MaxTokenLifetime 属性。在此示例中，将最长令牌生存期设置为 4 小时（04 小时:00 分钟:00 秒）的设置。