Set-CsUserServer
上一次修改主题： 2012-04-23
使您可以修改现有的用户服务池。用户服务池的功能之一是提供状态信息并帮助管理会议。
语法
Set-CsUserServer [-Identity <XdsGlobalRelativeIdentity>] [-ConferenceServer <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-McuFactorySipPort <UInt16>] [-UserDatabase <String>] [-WhatIf [<SwitchParameter>]]
详细说明
用户服务是执行许多关键 Microsoft Lync Server 2010 角色的多功能组件；例如，用户服务可以提供状态信息，帮助管理会议（通过会议状态中心和会议中心），处理用户授权和用户级别路由，以及用作后端数据库的主要接口。用户服务还可以帮助设置用户帐户。
因此，管理员必须准确了解其用户服务池是如何配置的，并根据需要修改这些配置，这一点非常重要。可以使用以下命令来检索有关用户服务池的信息：
Get-CsService -UserServer
同样，可以使用 Set-CsUserServer cmdlet 更改任何此类池。通过 Set-CsUserServer，管理员可以更改用户数据库和/或与池关联的会议服务器。还可以通过该 cmdlet 修改用于连接到会议中心的端口。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsUserServer cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUserServer"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要修改的用户服务池的唯一标识符。例如：-Identity "UserServer:atl-cs-001.litwareinc.com"。 请注意，在指定用户服务器时，可以省略前缀“UserServer:”。例如：-Identity "atl-cs-001.litwareinc.com"。 |
ConferenceServer |
可选 |
字符串 |
与用户服务池关联的会议服务器的服务 ID。例如：-ConferenceServer "ConferenceServer:atl-cs-001.litwareinc.com"。 |
McuFactorySipPort |
可选 |
整数 |
用于连接到会议中心 (McuFactory) 的端口。会议中心分配媒体控制单元 (MCU) 以向会议添加特定媒体类型（如音频）。 |
UserDatabase |
可选 |
字符串 |
与用户服务池关联的用户数据库的服务 ID。例如：-UserDatabase "UserDatabase:atl-cs-001.litwareinc.com"。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。Set-CsUserServer 不接受通过管道传递的输入。
返回类型
Set-CsUserServer 不会返回任何对象或值。此 cmdlet 会修改 Microsoft.Rtc.Management.Xds.DisplayUserServer 对象的现有实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsUserServer -Identity "UserServer:atl-cs-001.litwareinc.com" -McuFactorySipPort 445
示例 1 中显示的命令更改单个用户服务池的 McuFactorySipPort：Identity 为 UserServer:atl-cs-001.litwareinc.com 的池。在此示例中，将端口更改为 445。
-------------------------- 示例 2 --------------------------
Get-CsService -UserServer | ForEach-Object {Set-CsUserServer -Identity $_.Identity -McuFactorySipPort 445}
示例 2 中显示的命令是示例 1 中所显示命令的变体。但在此示例中，修改组织中所有用户服务池的 McuFactorySipPort。为执行此操作，该命令首先使用 Get-CsService 和 UserServer 参数以返回当前正在使用的所有用户服务池的集合。然后将该集合通过管道传递到 ForEach-Object cmdlet，后者将选取集合中的每个池，并将 McuFactorySipPort 设置为 445。由于 Set-CsUserServer cmdlet 本身无法接受通过管道传递的数据，因此必须将数据通过管道传递到 ForEach-Object。