Set-CsEdgeServer
上一次修改主题： 2012-03-26
修改一个或多个边缘服务器的属性值。边缘服务器用于提供内部网络与 Internet 之间的连接。
语法
Set-CsEdgeServer [-Identity <XdsGlobalRelativeIdentity>] [-AccessEdgeClientSipPort <UInt16>] [-AccessEdgeExternalSipPort <Nullable>] [-AccessEdgeInternalSipPort <UInt16>] [-Confirm [<SwitchParameter>]] [-DataPsomClientPort <Nullable>] [-DataPsomServerPort <UInt16>] [-Force <SwitchParameter>] [-MediaCommunicationPortCount <UInt16>] [-MediaCommunicationPortStart <UInt16>] [-MediaRelayAuthEdgePort <UInt16>] [-MediaRelayExternalTurnTcpPort <UInt16>] [-MediaRelayExternalTurnUdpPort <UInt16>] [-MediaRelayInternalTurnTcpPort <UInt16>] [-MediaRelayInternalTurnUdpPort <UInt16>] [-Registrar <String>] [-WhatIf [<SwitchParameter>]]
详细说明
与外部世界的连接（即，与 Internet 的连接）是 Microsoft Lync Server 2010 的一个重要方面。如果没有此连接，则用户必须先登录到内部网络，然后才能访问 Lync Server 2010。这使得在非现场办公的用户很难使用该软件，并使在您的域中没有帐户的用户无法参与会议。同样，如果没有与组织外部的连接，用户将无法与联盟伙伴或在公共即时消息系统（如 Yahoo!、AOL 或 MSN）中具有帐户的用户交换即时消息。
边缘服务器用于帮助提供内部网络与 Internet 之间的连接。Set-CsEdgeServer cmdlet 用于修改边缘服务器的配置设置，该项任务主要涉及更改用于传输网络流量的端口号。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsEdgeServer cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsEdgeServer"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要修改的边缘服务器的服务位置。例如：-Identity "EdgeServer:atl-edge-001.litwareinc.com"。 请注意，在指定边缘服务器时可以省略前缀“EdgeServer:”。例如：-Identity "atl-cs-001.litwareinc.com"。 |
AccessEdgeClientSipPort |
可选 |
整数 |
用于边缘服务器与客户端设备之间的 SIP 通信的端口。初始值是在拓扑生成器中设置的，但可通过为此参数指定一个新值来修改初始值。 |
AccessEdgeExternalSipPort |
可选 |
整数 |
用于外部 SIP 流量的端口。默认值为 5061。 |
AccessEdgeInternalSipPort |
可选 |
整数 |
用于内部 SIP 通信的端口。默认值为 5061。 |
DataPsomClientPort |
可选 |
整数 |
用于边缘服务器与客户端设备之间的持续性共享对象模型 (PSOM) 通信的端口。初始值是在拓扑生成器中设置的，但可通过为此参数指定一个新值来修改初始值。 |
DataPsomServerPort |
可选 |
整数 |
用于边缘服务器与其他服务器之间的 PSOM 通信的端口。 |
MediaCommunicationPortCount |
可选 |
整数 |
外部边缘上分配用于媒体通信的端口总数。默认值为 10000。 |
MediaCommunicationPortStart |
可选 |
整数 |
外部边缘上用于媒体通信的起始端口号。默认值为 50000。 |
MediaRelayAuthEdgePort |
可选 |
整数 |
用于媒体中继身份验证的端口。默认值为 5062。 |
MediaRelayExternalTurnTcpPort |
可选 |
整数 |
用于使用传输控制协议 (TCP) 的外部媒体中继流量的端口。如果边缘服务器只有一个 IP 地址，则默认值为 444。如果边缘服务器有多个 IP 地址，则默认值为 443。这些值最初是在拓扑生成器中设置的，但可通过为此参数指定一个新值来修改这些值。 |
MediaRelayExternalTurnUdpPort |
可选 |
整数 |
用于使用用户数据报协议 (UDP) 的外部媒体中继流量的端口。默认值为 3478。 |
MediaRelayInternalTurnTcpPort |
可选 |
整数 |
用于使用 TCP 的内部媒体中继流量的端口。默认值为 443。 |
MediaRelayInternalTurnUdpPort |
可选 |
整数 |
用于使用 UDP 的内部媒体中继流量的端口。默认值为 3478。 |
Registrar |
可选 |
字符串 |
要与边缘服务器关联的注册器的服务位置。例如：-Registrar "Registrar:atl-cs-001.litwareinc.com"。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。Set-CsEdgeServer 不接受通过管道传递的输入。
返回类型
Set-CsEdgeServer 不会返回任何对象或值。此 cmdlet 会修改 Microsoft.Rtc.Management.Xds.DisplayEdgeServer 对象的现有实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsEdgeServer -Identity "EdgeServer:atl-edge-001.litwareinc.com" -AccessEdgeInternalSipPort 5062 -AccessEdgeExternalSipPort 5062
示例 1 中显示的命令修改边缘服务器“EdgeServer:atl-edge-001.litwareinc.com”的内部和外部 SIP 端口。
-------------------------- 示例 2 --------------------------
Get-CsService -EdgeServer | Where-Object {$_.SiteId -eq "site:Redmond"} | ForEach-Object {Set-CsEdgeServer Identity $_.Identity -AccessEdgeInternalSipPort 5062 -AccessEdgeExternalSipPort 5062}
示例 2 修改位于 Redmond 站点中的所有边缘服务器的内部和外部 SIP 端口。为执行此操作，该命令首先使用 Get-CsService 和 EdgeServer 参数，以返回组织中当前使用的所有边缘服务器的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会仅选择 Redmond 站点中的边缘服务器；也就是说，SiteId 属性等于 site:Redmond 的服务器。然后，将筛选出的集合通过管道传递到 For-Each-Object cmdlet。该 cmdlet 将针对集合中的每个服务器运行 Set-CsEdgeServer，从而更改分配给 AccessInternalSipPort 和 AccessExternalSipPort 属性的值。