Set-CsTrunkConfiguration
上次修改主題的時間： 2012-03-25
修改現有的主幹組態，此組態會描述主幹對等實體 (例如，服務提供者的公用交換電話網路 (PSTN) 閘道、IP 公用交換機 (PBX) 或工作階段界限控制器 (SBC)) 的設定。
語法
Set-CsTrunkConfiguration [-Identity <XdsIdentity>] [-ConcentratedTopology <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBypass <$true | $false>] [-EnableMobileTrunkSupport <$true | $false>] [-EnablePIDFLOSupport <$true | $false>] [-EnableReferSupport <$true | $false>] [-EnableSessionTimer <$true | $false>] [-EnableSignalBoost <$true | $false>] [-Force <SwitchParameter>] [-MaxEarlyDialogs <UInt32>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]
Set-CsTrunkConfiguration [-ConcentratedTopology <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBypass <$true | $false>] [-EnableMobileTrunkSupport <$true | $false>] [-EnablePIDFLOSupport <$true | $false>] [-EnableReferSupport <$true | $false>] [-EnableSessionTimer <$true | $false>] [-EnableSignalBoost <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxEarlyDialogs <UInt32>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]
詳細描述
使用此指令程式可修改適用於 PSTN 閘道實體的主幹組態。每個組態均含有主幹對等實體 (例如，服務提供者的 PSTN 閘道、IP-PBX 或 SBC) 的專屬設定。這些設定所設定的項目包括此主幹是否啟用媒體旁路、是否在特定情況下傳送即時傳輸控制通訊協定 (RTCP) 封包，以及是否需要安全即時通訊協定 (SRTP) 加密。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsTrunkConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsTrunkConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
XdsIdentity |
包含主幹組態範圍的唯一識別碼。主幹組態可存在於全域範圍、網站範圍或 PSTN 閘道服務的服務範圍上。例如，site:Redmond (網站) 或 PstnGateway:Redmond.litwareinc.com (服務)。 |
Instance |
選用 |
TrunkConfiguration |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 這個參數必須有 Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration 類型的物件，其可藉由呼叫 Get-CsTrunkConfiguration 指令程式來加以擷取。 |
ConcentratedTopology |
選用 |
布林值 |
此參數的值會決定是否有已知的媒體終端點。(舉例來說，PSTN 閘道就是已知的媒體終端點，其中媒體終端的 IP 與訊號終端相同)。如果主幹沒有已知的媒體終端點，請將此值設為 False。 預設值：True |
Description |
選用 |
字串 |
描述主幹組態用途的字串。 |
EnableBypass |
選用 |
布林值 |
此參數的值可決定是否啟用此主幹的媒體旁路。將這個值設為 True 以啟用旁路功能。請注意，為了使媒體旁路得以順利運作，PSTN 閘道、SBC 及 PBX 必須支援某些功能，包括： - 能夠接收對 Invite 的分支回應。 - Lync Server 2010 用戶端與媒體終端點必須能夠直接通訊，而不必經由中繼伺服器。 - 閘道子網路必須定義為位在與用戶端的子網路相同的網站，如果位在不同的網站，則網站必定無法由頻寬受限的 WAN 連結加以區別。 媒體旁路只能在下列情況下啟用： - ConcentratedTopology 參數已設為 True - EnableReferSupport 參數已設為 False 且 RTCPActiveCalls 和 RTCPCallsOnHold 已設為 False，或是 EnableReferSupport 已設為 True 請注意，如果 EnableBypass 為 True 且 EnableReferSupport 為 False，後續傳輸的旁路通話將成為非旁路通話。 為了讓特定主幹的媒體旁路能運作，媒體旁路必須通用啟用，上述之主幹的媒體旁路也必須啟用。使用 New-CsNetworkMediaBypassConfiguration Cmdlet 以通用啟用媒體旁路。 預設值：False |
EnableMobileTrunkSupport |
選用 |
布林值 |
定義服務提供者是否為行動裝置電信業者。 預設值：False |
EnablePIDFLOSupport |
選用 |
布林值 |
定義是否要透過已定義的閘道傳送含目前狀態資訊資料格式位置物件 (PIDF-LO) 的緊急通話。如果要將緊急通話傳送到取得認證的緊急服務提供者，請將此參數設為 True (位置將隨通話一併傳送)。 預設值：False |
EnableReferSupport |
選用 |
布林值 |
定義此主幹是否支援接收來自中繼伺服器的 Refer 要求。 媒體旁路只能在下列情況下啟用： - ConcentratedTopology 參數已設為 True - EnableReferSupport 參數已設為 False 且 RTCPActiveCalls 和 RTCPCallsOnHold 已設為 False，或是 EnableReferSupport 已設為 True 請注意，如果 EnableBypass 為 True 且 EnableReferSupport 為 False，後續傳輸的旁路通話將成為非旁路通話。 預設值：True |
EnableSessionTimer |
選用 |
布林值 |
指定是否啟用工作階段計時器。工作階段計時器用於決定特定的工作階段是否仍為使用中。 請注意，即使此參數已設為 False，倘若遠端連線啟用工作階段計時器，仍可套用工作階段計時器。在這種情況下，中繼伺服器將從遠端實體回覆工作階段計時器探查。 預設值：False |
EnableSignalBoost |
選用 |
布林值 |
此參數設為 True 時，服務提供者的 PSTN 閘道、IP-PBX 或 SBC 將增加傳送到中繼伺服器或 Microsoft Lync Server 2010 用戶端之語音串流的音訊音量。如果將此值設為 False，音訊音量會在中繼伺服器 (非旁路通話) 或在 Lync Server 2010 用戶端 (旁路通話) 中增強。 預設值：False |
MaxEarlyDialogs |
選用 |
Int64 |
服務提供者的 PSTN 閘道、IP-PBX 或 SBC 對其傳送到中繼伺服器的 Invite，可接收的分支回應數上限。 預設值：20 |
OutboundTranslationRulesList |
選用 |
PSListModifier |
電話號碼轉譯規則的集合，這些規則會套用到輸出路由所處理的電話 (亦即路由到 PBX 或 PSTN 目的地的電話)。 雖然可使用此 Cmdlet 直接修改清單與這些規則，但我們仍建議您使用 Set-CsOutboundTranslationRule Cmdlet 修改輸出轉譯規則。Set-CsOutboundTranslationRule 將修改規則，這些修改會自動反映在主幹組態中。若要藉由新增輸出轉譯規則來修改主幹組態，請呼叫 New-CsOutboundTranslationRule Cmdlet；新規則將新增到含符合範圍的主幹組態。 |
RemovePlusFromUri |
選用 |
布林值 |
將此參數設為 True 將造成中繼伺服器先移除統一資源識別元 (URI) 前置的加號 (+)，再將這些 URI 傳送到服務提供者。 預設值：False |
RTCPActiveCalls |
選用 |
布林值 |
此參數可決定目前通話是否可從服務提供者的 PSTN 閘道、IP-PBX 或 SBC 傳送 RTCP 封包。此處的目前通話指的是至少允許媒體流向一個方向的通話。如果 RTCPActiveCalls 設為 True，當中繼伺服器或 Lync Server 用戶端未在 30 秒內收到 RTCP 封包時，便能終止通話。 請注意，在 Lync Server 元素中停用目前通話的 RTCP 媒體接收檢查也會移除重要的對等中斷偵測防護，因此若非絕對必要，請勿採用。 預設值：True |
RTCPCallsOnHold |
選用 |
布林值 |
此參數會決定保留中、且預期將無任何媒體封包流向任一方向之通話的 RTCP 封包是否繼續在主幹中傳送。如果已在 Lync Server 用戶端或主幹啟用等候音樂，此通話將被視為目前通話，並且會忽略此內容。在上述情況下，請使用 RTCPActiveCalls 參數。 請注意，在 Lync Server 元素中停用目前通話的 RTCP 媒體接收檢查也會移除重要的對等中斷偵測防護，因此若非絕對必要，請勿採用。 預設值：True |
SipResponseCodeTranslationRulesList |
選用 |
PSListModifier |
SIP 回應碼轉譯規則清單，這些規則會套用在從服務提供者之 PSTN 閘道、IP-PBX 或 SBC 接收到的回應碼。這些規則可讓系統管理員將透過主幹接收到的 SIP 回應碼值 (介於 400 到 699 之間) 對應到和 Lync Server 比較一致的新值。 儘管您可以使用這個 Cmdlet 建立此清單和對應的規則，不過我們還是建議您呼叫 New-CsSipResponseCodeTranslationRule Cmdlet 來建立 SIP 回應碼轉譯規則。這個 Cmdlet 除了能建立規則之外，還能將規則指派給範圍相符的主幹組態。 |
SRTPMode |
選用 |
SRTPMode |
此參數的值會決定 SRTP 的支援層級，以保護中繼伺服器和服務提供者之 PSTN 閘道、IP-PBX 或 SBC 之間的媒體流量。若是媒體旁路的情況，此值必須與媒體組態中的 EncryptionLevel 設定相容。媒體組態必須使用 New-CsMediaConfiguration 和 Set-CsMediaConfiguration 指令程式來加以設定。 有效值： - Required：必須使用 SRTP 加密。 - Optional：如果服務提供者支援 SRTP，則使用 SRTP。 - NotSupported:不支援 SRTP 加密，因此不會使用此加密。 附註：只有閘道設定為使用傳輸層安全性 (TLS) 時，才能使用 SRTPMode。如果將閘道設定為在傳輸時使用傳輸控制通訊協定 (TCP)，系統會從內部將 SRTPMode 設為 NotSupported。 預設值：必要 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration 物件。接受主幹組態物件管線傳送的輸入。
傳回類型
此指令程式不會傳回值，它會修改 Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration 類型的物件。
範例
-------------------------- 範例 1 ------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True
此範例會使用 Identity site:Redmond 來修改主幹組態，以啟用媒體旁路。藉由將 $True 值指派給 EnableBypass 參數以啟用媒體旁路。此組態剩下的屬性將保留現有的值。
-------------------------- 範例 2 ------------------------
Set-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Translation '$1'
此範例會使用 Identity site:Redmond 來修改為主幹組態定義的輸出轉譯規則。請注意，我們實際上不會撥打電話至 Set-CsTrunkConfiguration 指令程式來進行此變更。使用 Set-CsOutboundTranslationRule 進行的變更將自動反映在 Identity 符合輸出轉譯規則之 Identity 的範圍部分的主幹組態中。
-------------------------- 範例 3 ------------------------
Get-CsTrunkConfiguration -Filter site:* | Set-CsTrunkConfiguration -SRTPMode "Optional"
範例 3 將網站範圍定義之所有主幹組態的 SRTPMode 設定為 Optional。命令的第一部分為呼叫 Get-CsTrunkConfiguration 指令程式，該指令程式會使用 Filter 參數擷取 Identity 開頭為 site: 的所有主幹組態，亦即在網站層級定義的所有主幹組態。組態的集合隨即便傳送到 Set-CsTrunkConfiguration 指令程式，此指令程式會將每個組態的 SRTPMode 屬性設為 Optional。
-------------------------- 範例 4 ------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnablePIDFLOSupport $True
範例 4 會使用 Identity site:Redmond 來修改主幹組態，以啟用 PIDF-LO 支援。EnablePIDFLOSupport 參數預設為 False。在此範例中，我們已將該值設為 True 以啟用緊急電話的位置支援。您必須將 EnablePIDFLOSupport 設定為 True，以便位置資訊可以透過輸出路由應用程式傳送至主幹。