Remove-CsAVEdgeConfiguration
上一次修改主题： 2012-03-27
使您可以删除现有的已应用于运行访问边缘服务的计算机（这些计算机也称为 A/V 边缘服务器）的配置设置集合。通过 A/V 边缘服务器，内部用户可以与外部用户（即未登录到内部网络的用户）共享音频和视频数据。
语法
Remove-CsAVEdgeConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
A/V 边缘服务器提供了一种跨组织防火墙交换音频和视频通信的方法。此方法的功能之一是使用户可以通过 Internet 使用 Microsoft Lync Server 2010，然后与从防火墙内登录到系统的用户交换音频和视频数据。边缘服务器配置设置可以在 global 作用域、site 作用域和 service 作用域进行分配。通过 A/V 边缘配置设置，管理员可以管理用户身份验证在必须进行续订之前的有效期，并限制单个用户或单个端口可以使用的带宽量等。
Remove-CsAVEdgeConfiguration cmdlet 使您可以删除已应用于 site 或 service 作用域的 A/V 边缘配置设置。该 cmdlet 也可以针对全局设置运行，但不会删除这些全局设置。而是将包含在全局集合中的属性全部重置为默认值。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsAVEdgeConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsAVEdgeConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的 A/V 边缘配置设置集合的唯一标识符。要“删除”全局集合，请使用以下语法：-Identity global。（如前所述，不能删除这些全局设置，只能将属性重置为默认值。）要删除一个站点集合，请使用类似如下的语法：-Identity site:Redmond。应使用类似如下的语法引用在 service 作用域配置的设置： -Identity service:EdgeServer:atl-cs-001.litwareinc.com 指定策略 Identity 时不能使用通配符。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings 对象。Remove-CsAVEdgeConfiguration 接受通过管道传递的媒体中继设置对象的输入。这些对象可通过运行 Get-CsAVEdgeConfiguration cmdlet 进行检索。
返回类型
Remove-CsAVEdgeConfiguration 不会返回值或对象。此 cmdlet 会删除 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsAVEdgeConfiguration -Identity site:Redmond
上述命令删除 Identity 为 site:Redmond 的 A/V 边缘配置设置。删除这些设置后，Redmond 站点内的 A/V 边缘服务器将由全局配置设置管理。
-------------------------- 示例 2 --------------------------
Get-CsAVEdgeConfiguration -Filter "service:*" | Remove-CsAVEdgeConfiguration
在示例 2 中，删除所有在 service 作用域应用的 A/V 边缘配置设置。为执行此操作，该命令首先调用带有 Filter 参数的 Get-CsAVEdgeConfiguration，筛选器值“service:*”可确保仅返回在 service 作用域配置的设置。然后，将筛选出的集合通过管道传递到 Remove-CsAVEdgeConfiguration，后者将删除集合中的每一项。
-------------------------- 示例 3 --------------------------
Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -lt 5000} | Remove-CsAVEdgeConfiguration
示例 3 中显示的命令删除 MaxBandwidthPerUserKB 属性的值小于 5000 KB/s 的所有 A/V 边缘配置设置。为完成此任务，此命令首先使用不带其他任何参数的 Get-CsAVEdgeConfiguration，以返回组织中当前正在使用的所有 A/V 边缘设置的集合。将该集合通过管道传递到 Where-Object cmdlet，后者将仅选择 MaxBandwidthPerUserKB 属性值小于 5000 的设置。然后将筛选出的集合通过管道传递到 Remove-CsAVEdgeConfiguration，后者将删除该集合中的每一项。