Set-CsUserServicesConfiguration
上一次修改主题： 2012-04-23
修改现有的用户服务配置设置集合。使用“用户服务”服务帮助维护状态信息，并管理会议。
语法
Set-CsUserServicesConfiguration [-Identity <XdsIdentity>] [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-MaintenanceTimeOfDay <DateTime>] [-MaxContacts <UInt16>] [-MaxPersonalNotes <UInt32>] [-MaxScheduledMeetingsPerOrganizer <UInt32>] [-MaxSubscriptionExpiration <Int64>] [-MaxSubscriptions <UInt16>] [-MinSubscriptionExpiration <Int64>] [-SubscribeToCollapsedDG <$true | $false>] [-WhatIf [<SwitchParameter>]]
Set-CsUserServicesConfiguration [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaintenanceTimeOfDay <DateTime>] [-MaxContacts <UInt16>] [-MaxPersonalNotes <UInt32>] [-MaxScheduledMeetingsPerOrganizer <UInt32>] [-MaxSubscriptionExpiration <Int64>] [-MaxSubscriptions <UInt16>] [-MinSubscriptionExpiration <Int64>] [-SubscribeToCollapsedDG <$true | $false>] [-WhatIf [<SwitchParameter>]]
详细说明
Microsoft Lync Server 2010 依赖于“用户服务”服务来帮助维护用户的状态信息以及管理会议。另一方面，CsUserServicesConfiguration cmdlet 用于在 global、site 和 service 作用域管理“用户服务”配置设置。（请注意，可以托管用户服务配置设置的唯一服务是“用户服务”服务自身。）这些设置可帮助确定以下内容：一个用户可以具有的联系人数目，一个用户在任意时间可以预定的会议数目，以及一次指定会议可以保持有效的时间长度。
Set-CsUserServicesConfiguration cmdlet 可供管理员修改当前使用的任何（或所有）有关用户服务配置设置的信息。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsUserServicesConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUserServicesConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要修改的用户服务配置设置的唯一标识符。要修改全局设置，请使用此语法：-Identity global。要修改在站点作用域配置的设置，请使用类似语法：-Identity site:Redmond。要修改服务级别的设置，请使用此类语法：-Identity service:UserServer:atl-cs-001.litwareinc.com。 |
Instance |
可选 |
用户服务设置对象 |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
AnonymousUserGracePeriod |
可选 |
时间跨度 |
表示当会议中不存在经过身份验证的用户时，匿名（未经身份验证）用户可以停留在会议中的时间。例如，如果此值设置为 15 分钟，则匿名用户最多可以在会议中停留 15 分钟，除非一个经过身份验证的用户加入进来。如果在宽限期结束前没有经过身份验证的用户加入进来，则匿名用户将被从会议中删除。此设置同时适用于预定的会议和通过单击 Microsoft Lync 中的“现在开会”创建的临时会议。 AnonymousUserGracePeriod 必须使用以下格式进行指定：days.minutes:seconds（例如，30 分钟显示为 0.00:30:00）。宽限期可以设置为 0 秒和 1 天之间的任意值；默认值是 90 分钟(01:30:00)。 |
DeactivationGracePeriod |
可选 |
时间跨度 |
会议可以持续的最长时间。此值必须使用以下格式进行指定：days.hours:minutes:seconds。例如，要使会议持续 60 个小时，应使用的格式如下：2.12:00:00（2 天:12 小时：00 分钟:00 秒）的设置。 DeactivationGracePeriod 的值必须在 8 小时和 365 天之间（包含边界值）。默认值是 1 天。 |
DefaultSubscriptionExpiration |
可选 |
整数 |
Subscriptions 在每次用户请求诸如状态信息之类的数据时创建。发生请求时，用户（或者更准确的说，是用户的客户端应用程序）可以请求 Subscription 保留多久的有效时间后才必须续订。如果没有发出这样的请求，则 Subscription 将被设置为由 DefaultSubscriptionExpiration 属性指定的值。 默认 Subscription 时间必须为 300 秒（5 分钟）和 86400 秒（24 小时）之间的任意整数值（包含边界值）。默认值为 28800 秒（8 小时）。 |
MaintenanceTimeOfDay |
可选 |
日期时间 |
指示计划的定期数据库维护（比如清除过时的记录）发生的时间。此值必须指定为日期时间值，可以使用 24 小时制（如“14:00”），或 12 小时制（如“2:00 PM”）。 MaintenanceTimeOfDay 的默认值是 1:00 AM (01:00:00)。 |
MaxContacts |
可选 |
整数 |
用户可以拥有的最大联系人数；默认值是 250。MaxContacts 属性代表用户可以拥有的联系人的绝对最大数量。但是，可以使用 CsClientPolicy cmdlet 限制某些用户的最大联系人数量，使其小于 MaxContacts 的值。 |
MaxPersonalNotes |
可选 |
整数 |
指示在用户的注释历史记录中存储的个人注释的最大数。默认情况下，注释历史记录维护最后 3 条注释。可以在历史记录中维护的最大注释数是 10。 |
MaxScheduledMeetingsPerOrganizer |
可选 |
整数 |
在给定时间内一个用户可以充当组织者的最大会议数。默认值是 1000。这意味着，如果用户已是 1000 个会议的组织者，他/她将不能再安排新会议（第 1001 个会议）。 |
MaxSubscriptionExpiration |
可选 |
整数 |
Subscriptions 在每次用户请求诸如状态信息之类的数据时创建。发生请求时，用户（或者更准确的说，是用户的客户端应用程序）可以请求 Subscription 保留多久的有效时间后才必须续订。MaxSubscriptionExpiration 属性表示可以授予客户端的最大时间量。例如，如果最大时间设置为 28800 秒并且客户端请求的超时间隔为 86400 秒，则将给客户端最大允许过期期间：28800 秒。 最大 Subscription 时间必须为 300 秒（5 分钟）和 86400 秒（24 小时）之间的任意整数值（包含边界值）。默认值为 43200 秒（12 小时）。 |
MaxSubscriptions |
可选 |
整数 |
用户每次可以打开的 SIP 订阅对话框最大数。订阅对话框表示请求 SIP 资源。 |
MinSubscriptionExpiration |
可选 |
整数 |
Subscriptions 在每次用户请求诸如状态信息之类的数据时创建。发生请求时，用户（或者更准确的说，是用户的客户端应用程序）可以请求 Subscription 保留多久的有效时间后才必须续订。MinSubscriptionExpiration 属性表示可以授予客户端的最小时间量。例如，如果最小时间设置为 1200 秒并且客户端请求的超时间隔为 200 秒，则将给客户端最小允许过期期间：1200 秒。 最小 Subscription 时间必须为 300 秒（5 分钟）和 86400 秒（24 小时）之间的任意整数值（包含边界值）。默认值为 1200 秒（20 分钟）。 |
SubscribeToCollapsedDG |
可选 |
布尔值 |
如果设置为 True（默认值），则将允许客户端应用程序订阅联系人列表中当前未展开的通讯组。这使客户端可以维护组中每个成员的最新状态信息。如果设置为 False，客户端应用程序将不允许订阅“折叠”组。 |
Force |
可选 |
开关参数 |
取消显示命令运行过程中可能出现的任何非致命错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings 对象。Set-CsUserServicesConfiguration 接受通过管道传递的用户服务设置对象的实例。
返回类型
Set-CsUserServicesConfiguration 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsUserServicesConfiguration -Identity site:Redmond -AnonymousUserGracePeriod "00:30:00"
示例 1 中显示的命令可修改 Redmond 站点 (-Identity site:Redmond) 的用户服务配置设置。在此示例中，AnonymousUserGracePeriod 属性设置为 30 分钟（00 小时:30 分钟：00 秒）的设置。
-------------------------- 示例 2 --------------------------
Set-CsUserServicesConfiguration -Identity site:Redmond -MaintenanceTimeOfDay "13:30"
在示例 2 中，修改了应用于 Redmond 站点的用户服务配置设置的 MaintenanceTimeOfDay 属性。这是通过使用 MaintenanceTimeOfDay 参数并将参数值设置为 13:30 实现的。此操作将维护时间设置为下午 1:30（24 小时制的 13:30）。
-------------------------- 示例 3 --------------------------
Get-CsUserServicesConfiguration -Filter "service:*" | Set-CsUserServicesConfiguration -MaxContacts 300
上述命令可以检索适用于 service 作用域的所有用户服务配置设置，然后逐一修改这些项的允许联系人数。要执行此任务，该命令首先使用 Get-CsUserServicesConfiguration 和 Filter 参数检索 service 作用域配置的所有设置；筛选器值 “service:*” 限制返回的数据是 Identity 以 “service:” 字符串开头的设置。然后，将筛选出的集合传递到 Set-CsUserServicesConfiguration，它将接收集合中的每一项并将 MaxContacts 的属性值更改为 300。
-------------------------- 示例 4 --------------------------
Get-CsUserServicesConfiguration | Where-Object {$_.MaxContacts -gt 300} | Set-CsUserServicesConfiguration -MaxContacts 300
在示例 4 中，修改允许用户拥有超过 300 个联系人的所有用户服务配置设置；经过修改后，没有设置将允许超过 300 个联系人。为执行此操作，该命令首先调用不带任何其他参数的 Get-CsUserServicesConfiguration。这将返回组织中当前正在使用的所有用户服务配置设置的集合。然后，将此集合通过管道传递到 Where-Object cmdlet，后者将仅选取 MaxContacts 属性大于 300 的设置。接着，将筛选出的集合通过管道传递到 Set-CsUserServicesConfiguration，后者将接收该筛选出的集合中的每一项并将允许的联系人的最大数量更改为 300。