Set-CsWebServer
上一次修改主题： 2012-03-25
修改由 Microsoft Lync Server 2010 使用的一个或多个 Web 服务器服务。
语法
Set-CsWebServer [-Identity <XdsGlobalRelativeIdentity>] [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-Confirm [<SwitchParameter>]] [-ExternalFqdn <Fqdn>] [-ExternalHttpPort <UInt16>] [-ExternalHttpsPort <UInt16>] [-Force <SwitchParameter>] [-InternalFqdn <Fqdn>] [-McxSipExternalListeningPort <UInt16>] [-McxSipPrimaryListeningPort <UInt16>] [-PrimaryHttpPort <UInt16>] [-PrimaryHttpsPort <UInt16>] [-PublishedExternalHttpPort <UInt16>] [-PublishedExternalHttpsPort <UInt16>] [-PublishedPrimaryHttpPort <UInt16>] [-PublishedPrimaryHttpsPort <UInt16>] [-ReachExternalPsomServerPort <UInt16>] [-ReachPrimaryPsomServerPort <UInt16>] [-UserServer <String>] [-WhatIf [<SwitchParameter>]]
详细说明
Lync Server 2010 广泛使用 Web 服务器和 Web 服务。例如，可以使用 Web 服务（通讯簿查询 Web 服务）执行通讯簿查询。Lync Server 还托管可使用户执行诸如配置电话拨入式会议个人标识号 (PIN) 等操作的网页。由于 Web 服务器和 Web 服务承担重要角色，管理员必须了解如何配置这些服务器和服务。可以使用以下命令返回该信息：
Get-CsService –WebServer
某些情况下，管理员还必须能够更改 Web 服务器的配置方式。例如，可能需要修改用于外部 HTTP 或 HTTPS 连接的端口。此类端口更改（以及其他修改）可以使用 Set-CsWebServer cmdlet 完成。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsWebServer cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsWebServer"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
Web 服务池的唯一标识符。例如：-Identity "WebServer:atl-cs-001.litwareinc.com"。 请注意，指定 Web 服务器时，可以省略前缀“WebServer:”。例如：-Identity "atl-cs-001.litwareinc.com"。 |
AppSharingPortCount |
可选 |
整数 |
为应用程序共享分配的端口总数。实际打开的端口从配置的 AppSharingPortStart 值开始，包括为 AppSharingPortCount 指定的端口数范围内的所有端口。例如，如果将 AppSharingPortStart 设置为 60000，并将 AppSharingPortCount 设置为 100，那么会将端口 60000 至 60099 用于应用程序共享。默认值为 16383。 |
AppSharingPortStart |
可选 |
整数 |
为应用程序共享分配的端口范围内的第一个端口。默认值为 49152。 |
ExternalFqdn |
可选 |
字符串 |
用于从内部网络范围之外连接到 Web 服务池的完全限定域名 (FQDN)。例如：-ExternalFqdn "www.litwareinc.com"。 |
ExternalHttpPort |
可选 |
整数 |
使用 HTTP 协议建立的外部 Web 连接的端口号。默认值为端口 8080。 |
ExternalHttpsPort |
可选 |
整数 |
使用 HTTPS 协议建立的外部 Web 连接的端口号。默认值为端口 4443。 |
InternalFqdn |
可选 |
字符串 |
Mobility Service 的完全限定域名。InternalFqdn 应该只能从组织防火墙的内部访问。 |
McxSipExternalListeningPort |
可选 |
整数 |
Mobility Service 的外部侦听端口。 |
McxSipPrimaryListeningPort |
可选 |
整数 |
Mobility Service 的内部侦听端口。 |
PrimaryHttpPort |
可选 |
整数 |
使用 HTTP 协议建立的内部 Web 连接的端口号。默认值为端口 80。 |
PrimaryHttpsPort |
可选 |
整数 |
使用 HTTPS 协议建立的内部 Web 连接的端口号。默认值为端口 443。 |
PublishedExternalHttpsPort |
可选 |
整数 |
Mobility Service 的外部端口。 |
PublishedPrimaryHttpsPort |
可选 |
整数 |
Mobility Service 的内部端口。 |
ReachExternalPsomServerPort |
可选 |
整数 |
持续性共享对象模型协议（用于会议的 Microsoft 协议）的外部端口号。默认端口号为 8061。 |
ReachPrimaryPsomServerPort |
可选 |
整数 |
持续性共享对象模型 (PSOM) 协议（用于会议的 Microsoft 协议）的主端口号。默认端口号为 8060。 |
UserServer |
可选 |
字符串 |
与 Web 服务池关联的用户服务池的服务 ID。例如：-UserServer "UserServer:atl-cs-001.litwareinc.com"。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。Set-CsWebServer 不接受通过管道传递的输入。
返回类型
无。Set-CsWebServer 会修改 Microsoft.Rtc.Management.Xds.DisplayWebServer 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsWebServer -Identity "WebServer:atl-cs-001.litwareinc.com" -PrimaryHttpPort 89
示例 1 中显示的命令更改单个 Web 服务池的 PrimaryHttpPort：Identity 为 WebServer:atl-cs-001.litwareinc.com 的池。在此示例中，将端口更改为端口号 89。
-------------------------- 示例 2 --------------------------
Get-CsService -WebServer | ForEach-Object {Set-CsWebServer -Identity $_.Identity -PrimaryHttpPort 89}
示例 2 中显示的命令是示例 1 中显示的命令的变体，在此示例中，修改组织中所有 Web 服务池的 PrimaryHttpPort。为执行此操作，该命令首先使用 Get-CsService 和 WebServer 参数以返回当前使用的所有 Web 服务池的集合。然后将该集合通过管道传递到 ForEach-Object cmdlet，后者将选取集合中的每个池，并将 PrimaryHttpPort 设置为端口 89。由于 Set-CsWebServer cmdlet 自身无法接受通过管道传递的数据，因此必须将该数据通过管道传递到 ForEach-Object。