Get-CsBandwidthPolicyServiceConfiguration
上一次修改主题： 2012-03-23
检索一个或多个带宽策略服务配置。
语法
Get-CsBandwidthPolicyServiceConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsBandwidthPolicyServiceConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
呼叫允许控制 (CAC) 是一种确定是否允许根据带宽限制建立实时通信会话（如语音呼叫或视频呼叫）的方法。在 CAC 的 Microsoft Lync Server 2010 实现中，区域、站点、子网以及这些实体之间的关系和链接均在网络中定义，以便设置各实体之间的带宽限制。带宽策略服务是 Lync Server 2010 部署中执行 CAC 功能的组件，用于确定对于要建立的呼叫是否存在足够的带宽。Get-CsBandwidthPolicyServiceConfiguration cmdlet 会检索一个或多个带宽策略服务的设置。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsBandwidthPolicyServiceConfiguration cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsBandwidthPolicyServiceConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要检索的配置的唯一标识符。此标识符由作用域（对于全局配置），或者作用域和名称（对于站点级别配置，如 site:Redmond）组成。 |
Filter |
可选 |
字符串 |
包含一个或多个通配符的字符串，用于搜索所有带宽策略服务配置的 Identity 属性，以查找 Identity 与通配符模式匹配的每个配置。例如，筛选器值 site:* 会检索 Identity 值以字符串 site: 开头，并以任意字符集结尾的所有配置。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而不是从中央管理存储本身检索带宽策略服务配置。 |
输入类型
无。
返回类型
返回一个或多个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration 的对象。
示例
-------------------------- 示例 1 --------------------------
Get-CsBandwidthPolicyServiceConfiguration
示例 1 将检索在 Microsoft Lync Server 2010 实现过程中定义的所有带宽策略服务配置。
-------------------------- 示例 2 --------------------------
Get-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond
此示例将检索为 Redmond 站点 (-Identity site:Redmond) 定义的带宽策略服务配置。
-------------------------- 示例 3 --------------------------
Get-CsBandwidthPolicyServiceConfiguration -Filter site:*
在此示例中，我们将使用 Filter 参数检索在站点级别定义的所有带宽策略服务配置。通过将值 site:* 传递到 Filter 参数来完成此操作。这会搜索值以 site: 开头，后跟其他任意字符的所有带宽策略服务配置的 Identity 属性。因为所有站点级别配置的 Identity 值都是以 site: 开头，后跟站点名称，所以此筛选器将找到所有站点的全部配置。
-------------------------- 示例 4 --------------------------
Get-CsBandwidthPolicyServiceConfiguration | Where-Object {$_.MaxLogFileSizeMb -gt 4}
示例 4 将检索允许日志文件大小大于 4 MB 的所有带宽策略服务配置。该示例首先调用 Get-CsBandwidthPolicyServiceConfiguration cmdlet。正如示例 1 所示，此 cmdlet 将检索在 Lync Server 部署中定义的所有配置的集合。然后，将该集合通过管道传递到 Where-Object cmdlet。Where-Object 会通过集合（一次通过一项）进行循环。对于集合中的每一项，Where-Object 都会检查 MaxLogFileSizeMb 属性的值是否大于 (-gt) 4。如果是，则该项继续作为集合的一部分得到保留，并作为命令输出的一部分。如果 MaxLogFileSizeMb 的值小于或等于 4，则会忽略该项，不将其返回。