Remove-CsUserServicesConfiguration
上一次修改主题： 2012-03-27
删除“用户服务”配置设置的现有集合。使用“用户服务”服务帮助维护状态信息，并管理会议。
语法
Remove-CsUserServicesConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
Microsoft Lync Server 2010 依赖于“用户服务”服务来帮助维护用户的状态信息以及管理会议。另一方面，CsUserServicesConfiguration cmdlet 用于在 global、site 和 service 作用域管理“用户服务”配置设置。（请注意，可以托管用户服务配置设置的唯一服务是“用户服务”服务自身。）这些设置可帮助确定以下内容：一个用户可以具有的联系人数目，一个用户在任意时间可以预定的会议数目，以及一次指定会议可以保持有效的时间长度。
通过 Remove-CsUserServicesConfiguration cmdlet，您可以删除已在 site 或 service 作用域上应用的“用户服务”配置设置。还可以针对全局集合运行此 cmdlet。但在这种情况下，不会删除全局设置，因为无法将其删除。但全局集合中的所有属性将重置为其默认值。例如，如果已经将全局设置中的 MaxContacts 值更改为 500，然后运行 Remove-CsUserServciesConfiguration，则 MaxContacts 的值将重置为默认值 250。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsUserServicesConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsUserServicesConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的“用户服务”配置设置的唯一标识符。要删除在站点作用域配置的设置，请使用类似语法：-Identity site:Redmond。要删除服务级别的设置，请使用此类语法：-Identity service:UserServer:atl-cs-001.litwareinc.com。 还可对全局集合运行 Remove-CsUserServicesConfiguration。但在这种情况下，不会删除全局集合。但该集合中的所有属性将重置为其默认值。 |
Force |
可选 |
开关参数 |
取消显示命令运行过程中可能出现的任何非致命错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings 对象。Remove-CsUserServicesConfiguration 接受通过管道传递的用户服务设置对象的实例。
返回类型
无。Remove-CsUserServicesConfiguration 会删除 Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings 对象的现有实例。
示例
-------------------------- 示例 1 ------------------------
Remove-CsUserServicesConfiguration -Identity site:Redmond
示例 1 中显示的命令可删除 Redmond 站点 (-Identity site:Redmond) 的“用户服务”配置设置。
-------------------------- 示例 2 ------------------------
Get-CsUserServicesConfiguration -Filter "service:*:" | Remove-CsUserServicesConfiguration
在示例 2 中，将删除所有在 service 作用域应用的“用户服务”配置设置。为执行此操作，该命令调用带 Filter 参数的 Get-CsUserServicesConfiguration。筛选器值“service:*”将返回的数据限制为在 service 作用域配置的设置（即 Identity 是以字符“service:”开头的设置）。然后，将筛选出的此集合通过管道传递给 Remove-CsUserServicesConfiguration，后者将删除集合中的每一项。
-------------------------- 示例 3 ------------------------
Get-CsUserServicesConfiguration | Where-Object {$_.MaxContacts -gt 250} | Remove-CsUserServicesConfiguration
上述命令可删除允许用户拥有的联系人数超过 250 个的所有“用户服务”配置设置。为执行此任务，命令首先调用不带任何参数的 Get-CsUserServicesConfiguration，以返回当前使用的所有用户服务配置设置的集合。此集合通过管道传递到 Where-Object cmdlet，后者仅会选择 MaxContacts 属性的值大于 250 的设置。这些设置随后会通过管道传递到 Remove-CsUserServicesConfiguration cmdlet，并被该 cmdlet 删除。