Get-CsAVEdgeConfiguration
上一次修改主题: 2012-03-23
返回组织中运行 A/V 边缘服务的计算机的配置信息。通过这些计算机(也称为 A/V 边缘服务器)上的配置设置,内部用户可以与外部用户(即未登录内部网络的用户)共享音频和视频数据,还可以交换文件和参与桌面共享会话。
语法
Get-CsAVEdgeConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAVEdgeConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
A/V 边缘服务器提供了一种跨组织防火墙交换音频和视频通信的方法。此方法的功能之一是使用户可以通过 Internet 使用 Microsoft Lync Server 2010,然后与从防火墙内登录到系统的用户交换音频和视频数据。边缘服务器配置设置可以在 global 作用域、site 作用域和 service 作用域进行分配。通过 A/V 边缘配置设置,管理员可以管理用户身份验证在必须进行续订之前的有效期,并限制单个用户或单个端口可以使用的带宽量等。
Get-CsAVEdgeConfiguration cmdlet 提供了一种检索有关组织中当前正在使用的 A/V 边缘配置设置的信息的方法。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Get-CsAVEdgeConfiguration cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAVEdgeConfiguration"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
Xds 标识 |
要检索的 A/V 边缘配置设置集合的唯一标识符。要检索全局集合,请使用以下语法:-Identity global。要检索站点集合,请使用类似如下的语法:-Identity site:Redmond。应使用类似如下的语法引用在 service 作用域配置的设置:-Identity service:EdgeServer:atl-cs-001.litwareinc.com。请注意,在指定策略 Identity 时不能使用通配符。 如果未包含此参数,Get-CsAVEdgeConfiguration 将返回组织中当前正在使用的所有边缘配置设置的集合。 |
Filter |
可选 |
字符串 |
使您可以使用通配符指示要返回的 A/V 边缘配置设置。例如,要返回在 site 作用域配置的所有设置,请使用以下语法:-Filter site:*。要返回在 service 作用域配置的所有设置的集合,请使用以下语法:-Filter "service:*"。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本,而非中央管理存储本身检索 A/V 边缘配置数据。 |
输入类型
无。Get-CsAVEdgeConfiguration 不接受通过管道传递的输入。
返回类型
Get-CsAVEdgeConfiguration 返回 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsAVEdgeConfiguration
示例 1 中显示的命令返回配置为在组织中使用的所有 A/V 边缘配置设置的集合。调用不带其他任何参数的 Get-CsAVEdgeConfiguration 总是返回 A/V 边缘配置设置的完整集合。
-------------------------- 示例 2 --------------------------
Get-CsAVEdgeConfiguration -Identity site:Redmond
在示例 2 中,返回单个 A/V 边缘配置设置集合:Identity 为 site:Redmond 的集合。
-------------------------- 示例 3 --------------------------
Get-CsAVEdgeConfiguration -Filter "site:*"
上述命令返回在 site 作用域配置的所有 A/V 边缘配置设置的集合。为执行此操作,调用带有 Filter 参数的 Get-CsAVEdgeConfiguration,筛选器值“site:*”将返回数据限制为 Identity 以字符“site:”开头的设置。根据定义,这会将返回的数据限制为在 site 作用域配置的设置。
-------------------------- 示例 4 --------------------------
Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -gt 10000}
在示例 4 中,仅返回 MaxBandwidthPerUserKB 属性大于 10000 KB/s 的 A/V 边缘配置设置。为执行此任务,该命令首先调用不带任何参数的 Get-CsAVEdgeConfiguration,以返回当前正在使用的所有 A/V 边缘配置设置的集合。然后,将该集合通过管道传递到 Where-Object cmdlet,后者将仅挑选出 MaxBandwidthPerUserKB 大于 10000 kbps 的设置。
-------------------------- 示例 5 --------------------------
Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -eq 10000}
示例 5 与示例 4 中所示的命令类似,但是,在示例 5 中返回的仅是 MaxBandwidthPerUserKB 属性正好等于 10000 kbps 的 A/V 边缘设置。
-------------------------- 示例 6 --------------------------
Get-CsAVEdgeConfiguration | Where-Object {$_.MaxTokenLifetime -lt "08:00:00"}
示例 6 中显示的命令仅返回 MaxTokenLifetime 属性小于 8 小时(08 小时:00 分钟:00 秒)的 A/V 边缘配置设置。该命令首先调用不带任何参数的 Get-CsAVEdgeConfiguration 以返回组织中使用的所有 A/V 边缘配置设置的集合。然后,将该集合通过管道传递到 Where-Object cmdlet,后者将仅挑选出 MaxTokenLifetime 小于 8 小时 (08:00:00) 的设置。