Set-CsEdgeServer
上次修改主題的時間： 2012-03-26
修改一或多部 Edge Server 的屬性值。Edge Server 可用來提供內部網路和網際網路間的連線。
語法
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>]]
詳細描述
和外部世界的連線能力 (也就是使用網際網路) 是 Microsoft Lync Server 2010 的重要環節。若缺乏這類型的連線能力，使用者就必須要登入內部網路才能存取 Lync Server 2010。這會使得在異地工作的使用者難以使用軟體，也會使不具有網域帳戶的使用者無法參與會議。同樣地，若無法和組織的外部連線，使用者便無法和同盟夥伴或具有公用立即訊息系統 (如 Yahoo!、AOL 或 MSN) 之帳戶的人員交換立即訊息。
Edge Server 可用來提供內部網路和網際網路間的連線。Set-CsEdgeServer 指令程式可讓您修改 Edge Server 的組態設定。這項工作的內容主要是和變更用來傳輸網路流量的連接埠號碼相關。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsEdgeServer Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsEdgeServer"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要修改的 Edge Server 服務位置。例如：-Identity "EdgeServer:atl-edge-001.litwareinc.com"。 請注意，當您在指定 Edge Server 時，可以省略前置字元 "EdgeServer:"。例如：-Identity "atl-cs-001.litwareinc.com"。 |
AccessEdgeClientSipPort |
選用 |
整數 |
用來傳輸 Edge Server 和用戶端裝置間 SIP 通訊的連接埠。初始值會在拓撲產生器中設定，但可透過為此參數指定新值加以變更。 |
AccessEdgeExternalSipPort |
選用 |
整數 |
用來傳輸外部 SIP 流量的連接埠。預設值為 5061。 |
AccessEdgeInternalSipPort |
選用 |
整數 |
用來傳輸內部 SIP 流量的連接埠。預設值為 5061。 |
DataPsomClientPort |
選用 |
整數 |
用來傳輸 Edge Server 和用戶端裝置間持續性共用物件模型 (PSOM) 通訊的連接埠。初始值會在拓撲產生器中設定，但可透過為此參數指定新值加以變更。 |
DataPsomServerPort |
選用 |
整數 |
用來傳輸 Edge Server 和其他伺服器間 PSOM 通訊的連接埠。 |
MediaCommunicationPortCount |
選用 |
整數 |
針對媒體通訊在外部 Edge 上配置的連接埠總數。預設值為 10000。 |
MediaCommunicationPortStart |
選用 |
整數 |
外部 Edge 上之媒體通訊的起始連接埠號碼。預設值為 50000。 |
MediaRelayAuthEdgePort |
選用 |
整數 |
用於媒體轉送驗證的連接埠。預設值為 5062。 |
MediaRelayExternalTurnTcpPort |
選用 |
整數 |
用來透過傳輸控制通訊協定 (TCP) 傳輸外部媒體轉送流量的連接埠。如果您的 Edge Server 具有單一 IP 位址，預設值為 444。如果您的 Edge Server 具有多個 IP 位址，則預設值為 443。這些值會在拓撲產生器中初始設定，但可透過為此參數指定新值加以變更。 |
MediaRelayExternalTurnUdpPort |
選用 |
整數 |
用來透過使用者資料包通訊協定 (UDP) 傳輸外部媒體轉送流量的連接埠。預設值為 3478。 |
MediaRelayInternalTurnTcpPort |
選用 |
整數 |
用來透過 TCP 傳輸內部媒體轉送流量的連接埠。預設值為 443。 |
MediaRelayInternalTurnUdpPort |
選用 |
整數 |
用來透過 UDP 傳輸內部媒體轉送流量的連接埠。預設值為 3478。 |
Registrar |
選用 |
字串 |
要和 Edge Server 建立關聯的登錄器服務位置。例如：-Registrar "Registrar:atl-cs-001.litwareinc.com"。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。Set-CsEdgeServer 不會接受管線傳送的輸入。
傳回類型
Set-CsEdgeServer 不會傳回任何物件或值。而是此指令程式會修改 Microsoft.Rtc.Management.Xds.DisplayEdgeServer 物件的現有執行個體。
範例
-------------------------- 範例 1 ------------------------
Set-CsEdgeServer -Identity "EdgeServer:atl-edge-001.litwareinc.com" -AccessEdgeInternalSipPort 5062 -AccessEdgeExternalSipPort 5062
範例 1 所示的命令會修改 Edge Server "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 站台中所有 Edge Server 的內部和外部 SIP 連接埠。為達成此目的，此命令會先使用 Get-CsService 搭配 EdgeServer 參數，以傳回組織中目前正在使用的所有 Edge Server 集合。接著，將該集合傳送到 Where-Object 指令程式，這樣只會選取 Redmond 站台中的 Edge Server，即 SiteId 屬性等於 site:Redmond 的伺服器。這個篩選過的集合接著會傳送到 For-Each-Object 指令程式。該指令程式會針對集合中的每部伺服器執行 Set-CsEdgeServer，變更指派給 AccessInternalSipPort 和 AccessExternalSipPort 內容的值。