Set-CsBandwidthPolicyServiceConfiguration
上一次修改主题： 2012-03-27
修改现有的带宽策略服务配置。
语法
Set-CsBandwidthPolicyServiceConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-MaxLogFileSizeMb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]
Set-CsBandwidthPolicyServiceConfiguration [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LogCleanUpInterval <TimeSpan>] [-MaxLogFileSizeMb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]
详细说明
呼叫允许控制 (CAC) 是一种确定是否允许根据带宽限制建立实时通信会话（如语音呼叫或视频呼叫）的方法。在 CAC 的 Microsoft Lync Server 2010 实现中，区域、站点、子网以及这些实体之间的关系和链接均在网络中定义，以便设置各实体之间的带宽限制。带宽策略服务是 Lync Server 2010 部署中执行 CAC 功能的组件，用于确定对于要建立的呼叫是否存在足够的带宽。此 cmdlet 可修改现有的带宽策略服务配置。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsBandwidthPolicyServiceConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsBandwidthPolicyServiceConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要更改的配置的唯一标识符。此标识符将包含作用域（适用于全局配置）或作用域和名称（适用于站点级别配置，如 site:Redmond）。 |
Instance |
可选 |
BandwidthPolicyServiceConfiguration |
对带宽策略服务配置对象的引用。此对象的类型必须为带宽策略服务配置，可以通过调用 Get-CsBandwidthPolicyServiceConfiguration cmdlet 来检索此对象类型。 |
EnableLogging |
可选 |
布尔值 |
将此参数设置为 True 可生成与带宽策略服务相关的 CAC 故障和链接状态日志。 |
LogCleanUpInterval |
可选 |
TimeSpan |
删除 CAC 故障和链接状态日志之前的时间段。 该值必须在 1 天到 60 天之间的范围内。该值必须以 dd.hh:mm:ss 的格式输入，其中 d 为天数、h 为小时数、m 为分钟数、s 为秒数。例如，20 天可表示为 20.00:00:00。 |
MaxLogFileSizeMb |
可选 |
UInt32 |
允许日志文件达到的最大大小。此参数的值必须为正数，并以 MB 为单位指定文件大小。例如，要使日志文件的最大大小为 10 MB，请输入值 10。 |
MaxTokenLifetime |
可选 |
TimeSpan |
由带宽策略身份验证服务颁发的令牌将存在的最长时间。 该值必须在 1 小时到 24 小时之间的范围内。该值必须以 dd.hh:mm:ss 的格式输入，其中 d 为天数、h 为小时数、m 为分钟数、s 为秒数。例如，值为 12 小时可表示为 12:00:00。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration 对象。接受通过管道传递的带宽策略服务配置对象的输入。
返回类型
此 cmdlet 不会返回值。它可修改一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration 的对象。
示例
-------------------------- 示例 1 --------------------------
Set-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond -EnableLogging $true -MaxTokenLifetime 3:00:00 -LogCleanUpInterval 5.00:00:00
此示例修改 Redmond 站点 (-Identity site:Redmond) 的带宽策略服务配置。将此配置修改为：启用日志记录，将令牌的最长生存期更改为 3 小时，并将清除日志之前的天数更改为 5 天。此命令可完成所有这些操作。要启用日志记录，请将 EnableLogging 参数设置为 True ($true)。接下来，MaxTokenLifetime 参数将收到值 3:00:00，该值代表 3 小时。最后，LogCleanUpInterval 参数将收到值 05.00:00:00，该值代表 5 天。