New-CsTrunkConfiguration
上次修改主題的時間： 2012-03-27
建立新主幹組態，說明主幹對等實體的設定，例如服務供應商的公用交換電話網路 (PSTN) 閘道、IP 公用交換機 (PBX) 或 工作階段界限控制器 (SBC)。
語法
New-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>] [-InMemory <SwitchParameter>] [-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：下列群組的成員預設會獲授權可以在本機上執行 New-CsTrunkConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTrunkConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
XdsIdentity |
包含主幹組態範圍的唯一識別碼。主幹組態可在站台範圍或 PSTN 閘道服務的服務範圍上建立 (根據預設通用原則存在且無法移除或重新建立)。例如，site:Redmond (站台) 或 PstnGateway:Redmond.litwareinc.com (服務)。 |
ConcentratedTopology |
選用 |
布林值 |
此參數的值會決定是否有已知的媒體終端點。(舉例來說，PSTN 閘道就是已知的媒體終端點，其中媒體終端的 IP 與訊號終端相同)。如果主幹沒有已知的媒體終端點，請將此值設為 False。 預設值：True |
Description |
選用 |
字串 |
描述主幹組態用途的字串。 |
EnableBypass |
選用 |
布林值 |
此參數的值可決定是否啟用此主幹的媒體旁路。將這個值設為 True 以啟用旁路功能。請注意，為了使媒體旁路得以順利運作，PSTN 閘道、SBC 及 PBX 必須支援某些功能，包括： - 能夠接收對 Invite 的分支回應。 - Microsoft Lync Server 2010 用戶端與媒體終端點必須能夠直接通訊，而不必經由中繼伺服器。 - 閘道子網路必須定義為位在與用戶端的子網路相同的站台，如果位在不同的站台，則站台必定無法由頻寬受限的 WAN 連結加以區別。 媒體旁路只能在下列情況下啟用： - ConcentratedTopology 參數已設為 True - EnableReferSupport 參數已設為 False 且 RTCPActiveCalls 和 RTCPCallsOnHold 已設為 False，或是 EnableReferSupport 已設為 True 請注意，如果 EnableBypass 為 True 且 EnableReferSupport 為 False，後續傳輸的旁路通話將成為非旁路通話。 為了讓特定主幹的媒體旁路能運作，媒體旁路必須通用啟用，上述之主幹的媒體旁路也必須啟用。使用 New-CsNetworkMediaBypassConfiguration 指令程式以通用啟用媒體旁路。 預設值：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 目的地的電話)。 雖然可以直接使用此指令程式來建立此清單和這些規則，但建議您使用 New-CsOutboundTranslationRule 指令程式來建立輸出轉譯規則，這樣將會建立規則並將它指派給含相符範圍的主幹組態。 |
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 比較一致的新值。 儘管您可以使用這個指令程式建立此清單和對應的規則，不過我們還是建議您呼叫 New-CsSipResponseCodeTranslationRule 指令程式來建立 SIP 回應碼轉譯規則。這個指令程式除了能建立規則之外，還能將規則指派給範圍相符的主幹組態。 |
SRTPMode |
選用 |
SRTPMode |
此參數的值會決定 SRTP 的支援層級，以保護中繼伺服器和服務提供者之 PSTN 閘道、IP-PBX 或 SBC 之間的媒體流量。若是媒體旁路的情況，此值必須與媒體組態中的 EncryptionLevel 設定相容。媒體組態必須使用 New-CsMediaConfiguration 和 Set-CsMediaConfiguration 指令程式來加以設定。 有效值： - Required：必須使用 SRTP 加密。 - Optional：如果閘道支援，即會使用 SRTP。 - NotSupported:不支援 SRTP 加密，因此不會使用此加密。 附註：只有閘道設定為使用傳輸層安全性 (TLS) 時，才能使用 SRTPMode。如果將閘道設定為在傳輸時使用傳輸控制通訊協定 (TCP)，系統會從內部將 SRTPMode 設為 NotSupported。 預設值：必要 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration 類型的物件。
範例
-------------------------- 範例 1 ------------------------
New-CsTrunkConfiguration -Identity site:Redmond
此範例會建立 Identity 為 site:Redmond 的新主幹組態。此新組態的其餘屬性將會填入預設值。
-------------------------- 範例 2 ------------------------
New-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True
此範例會建立 Identity 為 site:Redmond 的新主幹組態，並略過媒體。藉由將 $True 值指派給 EnableBypass 參數以啟用媒體旁路。此新組態的其餘屬性將會填入預設值。
-------------------------- 範例 3 ------------------------
New-CsTrunkConfiguration -Identity site:Redmond
New-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Pattern '^\+(\d{8})$' -Translation '9$1'
此範例會建立 Identity 為 site:Redmond 的新主幹組態，然後將新的輸出轉譯指派給該主幹。範例的第一行會呼叫 New-CsTrunkConfiguration，利用預設設定來建立新的主幹組態。第二行會呼叫 New-CsOutboundTranslationRule 指令程式。請注意指派給 Identity:site:Redmond/OTR1 的值。Identity (site:Redmond) 的第一個部分會定義套用規則的範圍。此範圍會符合新主幹組態的 Identity，這表示此規則將自動套用至該組態。範圍後面會加上一個正斜線 (/) 和一個字串，此字串只是此規則的唯一名稱 (每個範圍可以有多個規則)。在此之後，我們需將值傳送給 Pattern 和 Translation 參數來定義此規則。