New-CsUserServicesConfiguration
上一次修改主题： 2012-04-23
创建新的 用户服务配置设置集合。使用“用户服务”服务帮助维护状态信息，并管理会议。
语法
New-CsUserServicesConfiguration -Identity <XdsIdentity> [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 作用域管理“用户服务”配置设置。（请注意，可以托管用户服务配置设置的唯一服务是“用户服务”服务自身。）这些设置可帮助确定以下内容：一个用户可以具有的联系人数目，一个用户在任意时间可以预定的会议数目，以及一次指定会议可以保持有效的时间长度。
New-CsUserServicesConfiguration cmdlet 为管理员提供了一种在 site 或 service 作用域创建新的用户服务配置设置集合的方法。（无法在 global 作用域创建新集合。）请注意，任何给定站点或服务最多只能具有一个用户服务配置设置集合。如果尝试为某个站点（如 Redmond 站点）创建设置，而该站点已托管了一个用户服务配置设置集合，则命令将失败。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsUserServicesConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell prompt 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsUserServicesConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要创建的用户服务配置设置的唯一标识符。要在 site 作用域创建设置，请使用类似如下的语法：-Identity site:Redmond。要在 service 级别创建设置，请使用类似如下的语法：-Identity service:UserServer:atl-cs-001.litwareinc.com。 |
AnonymousUserGracePeriod |
可选 |
TimeSpan |
表示当会议中不存在经过身份验证的用户时，匿名（未经身份验证）用户可以停留在会议中的时间。例如，如果此值设置为 15 分钟，则匿名用户最多可以在会议中停留 15 分钟，除非一个经过身份验证的用户加入进来。如果在宽限期结束前没有经过身份验证的用户加入进来，则匿名用户将被从会议中删除。此设置同时适用于预定的会议和通过单击 Microsoft Lync 中的“现在开会”创建的临时会议。 必须按照如下格式指定 AnonymousUserGracePeriod：days.hours:minutes:seconds（例如，0.00:30:00 表示 30 分钟）。可以将宽限期设置为 0 秒到 1 天之间的任意值，默认值是 90 分钟 (01:30:00)。 |
DeactivationGracePeriod |
可选 |
TimeSpan |
会议保持活动状态的最长时间。必须按照如下格式指定此值：days.hours:minutes:seconds。例如，要启用持续 60 小时的会议，应使用以下格式：2.12:00:00（2 天.12 小时:00 分钟:00 秒）的设置。 DeactivationGracePeriod 的值必须在 8 小时到 365 天之间（包含边界值）。默认值为 1 天 (1.00:00:00)。 |
DefaultSubscriptionExpiration |
可选 |
整数 |
用户请求数据（如状态信息）时会创建订阅。发出请求后，用户（更准确地说是用户的客户端应用程序）可以请求订阅在必须进行续订之前可以保持有效的时间长度。如果没有发出此类请求，则将订阅设置为 DefaultSubscriptionExpiration 属性指定的值。 默认 Subscription 时间必须为 300 秒（5 分钟）和 86400 秒（24 小时）之间（包含边界值）的任意整数值。默认值为 28800 秒（8 小时）。 |
MaintenanceTimeOfDay |
可选 |
DateTime |
指示每天按计划定期维护数据库（如清除过时记录）的时间。必须将该值指定为日期时间值。可以使用 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 |
可选 |
整数 |
用户请求数据（如状态信息）时会创建订阅。发出请求后，用户（更准确地说是用户的客户端应用程序）可以请求订阅在必须进行续订之前可以保持有效的时间长度。MaxSubscriptionExpiration 属性代表该客户端的最长允许订阅有效期。例如，如果最长时间设置为 28800 秒，而客户端请求的超时时间间隔为 86400 秒，系统将为该客户端指定允许的最长到期时间：28800 秒。 最大 Subscription 时间必须为 300 秒（5 分钟）和 86400 秒（24 小时）之间（包含边界值）的任意整数值。默认值为 43200 秒（12 小时）。 |
MaxSubscriptions |
可选 |
整数 |
在任一时间，用户可以打开的 SIP 订阅对话框的最大数量。订阅对话框代表对 SIP 资源的请求。默认值为 200。 |
MinSubscriptionExpiration |
可选 |
整数 |
用户请求数据（如状态信息）时会创建订阅。发出请求后，用户（更准确地说是用户的客户端应用程序）可以请求订阅在必须进行续订之前可以保持有效的时间长度。MinSubscriptionExpiration 属性代表该客户端的最短允许订阅有效期。例如，如果最短时间设置为 1200 秒，而客户端请求的超时时间间隔为 200 秒，系统将为该客户端指定允许的最短到期时间：1200 秒。 最小 Subscription 时间必须为 300 秒（5 分钟）和 86400 秒（24 小时）之间（包含边界值）的任意整数值。默认值为 1200 秒（20 分钟）。 |
SubscribeToCollapsedDG |
可选 |
布尔值 |
如果设置为 True（默认值），则将允许客户端应用程序订阅联系人列表中当前未展开的通讯组。这使客户端可以维护组中每个成员的最新状态信息。如果设置为 False，将不允许客户端应用程序订阅“折叠”的组。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
InMemory |
可选 |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。New-CsUserServicesConfiguration 不接受通过管道传递的输入。
返回类型
New-CsUserServicesConfiguration 创建 Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings 对象的新实例。
示例
-------------------------- 示例 1 --------------------------
New-CsUserServicesConfiguration -Identity site:Redmond -MaxContacts 500 -MaintenanceTimeOfDay "11:00 PM"
示例 1 中显示的命令为 Redmond 站点 (-Identity site:Redmond) 创建新的用户服务配置设置集合。除了指定 Identity 之外，该命令还设置最大联系人数 (-MaxContacts 500) 和每天的维护时间 (-MaintenanceTimeOfDay "11:00 PM")。请注意，如果已经为 Redmond 站点配置了用户服务设置，此命令将失败。这是因为限制您只能为每个站点创建一个设置集合。
-------------------------- 示例 2 --------------------------
$x = New-CsUserServicesConfiguration -Identity site:Redmond -InMemory
$x.MaxContacts = 500
$x.MaintenanceTimeOfDay = "11:00 PM"
Set-CsUserServicesConfiguration -Instance $x
示例 2 还为 Redmond 站点创建新的用户服务配置设置集合。但是，在此示例中，该集合初始时是在内存中创建的，随后才应用于 Redmond 站点。为执行此操作，该示例中的第一个命令使用 New-CsUserServicesConfiguration 和 InMemory 参数创建仅存在于内存中的新集合（Identity 为 site:Redmond）。由于此集合只存在于内存中，因此必须将用户服务对象存储在变量中。在此示例中，变量名为 $x。
创建虚拟集合后，使用第 2 和第 3 个命令修改 MaxContacts 和 MaintenanceTimeOfDay 属性的值。然后，此示例中的最后一个命令使用 Set-CsUserServicesConfiguration 将这些虚拟设置转换为应用于 Redmond 站点的实际用户服务配置设置集合。最后一步至关重要：如果不调用 Set-CsUserServicesConfiguration，将不会对 Redmond 站点应用设置，并且一旦终止 Windows PowerShell 会话或删除变量 $x，所有虚拟设置将立即消失。