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) 暗号化を要求するかどうかなどを構成します。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Set-CsTrunkConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsTrunkConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
XdsIdentity |
トランク構成のスコープを含む一意の識別子。トランク構成はグローバル スコープまたはサイト スコープでも、PSTN ゲートウェイ サービスのサービス スコープでも存在することができます。たとえば、site:Redmond (サイト用) または PstnGateway:Redmond.litwareinc.com (サービス用) です。 |
Instance |
省略可能 |
TrunkConfiguration |
個々のパラメーター値を設定するのではなく、オブジェクトへの参照をコマンドレットに渡せるようにします。 このパラメーターは、Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration 型のオブジェクトが必要です。このオブジェクトは、Get-CsTrunkConfiguration コマンドレットを呼び出すことで取得できます。 |
ConcentratedTopology |
省略可能 |
ブール値 |
このパラメーターの値で、既知のメディア終端ポイントがあるかどうかを指定します(既知のメディア終端ポイントの例として、メディア終端が信号終端と同じ IP を持つ PSTN ゲートウェイがあります)。トランクに既知のメディア終端ポイントがない場合、この値を False に設定します。 既定値は次のとおりです。True |
Description |
省略可能 |
文字列 |
トランク構成の目的を説明する文字列。 |
EnableBypass |
省略可能 |
ブール値 |
このパラメーターの値で、このトランクに対してメディア バイパスを有効にするかどうかを指定します。この値を True に設定するとバイパスを有効にできます。メディア バイパスが正常に機能するには、PSTN ゲートウェイ、SBC、PBX で次のような特定の機能がサポートされている必要があります。 - 招待に対する分岐された応答を受信する機能。 - 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 または PST にルーティングされる通話) に適用される、電話番号変換ルールのコレクション。 このコマンドレットを使用して、このリストとこれらのルールを直接変更することもできますが、Set-CsOutboundTranslationRule コマンドレットを使用して発信変換ルールを変更することをお勧めします。Set-CsOutboundTranslationRule を実行すると、ルールが変更されて、これらの変更がトランク構成に自動的に反映されます。新しい発信変換ルールを追加してトランク構成を変更するには、New-CsOutboundTranslationRule コマンドレットを呼び出します。新しいルールが、一致するスコープがあるトランク構成に追加されます。 |
RemovePlusFromUri |
省略可能 |
ブール値 |
このパラメーターを True に設定すると、仲介サーバー が Uniform Resource Identifier (URI) をサービス プロバイダーに送信する前に、その URI から先行する正符号 (+) を削除します。 既定値は次のとおりです。False |
RTCPActiveCalls |
省略可能 |
ブール値 |
このパラメーターでは、アクティブな通話に対して、RTCP パケットが PSTN ゲートウェイ、IP-PBX、またはサービス プロバイダーの SBC から送信されるかどうかを指定します。この場合のアクティブな通話とは、メディアが最低でも一方向に流れることのできる通話のことです。RTCPActiveCalls が True に設定されている場合、仲介サーバー または Lync Server クライアントは、30 秒を超過しても RTCP パケットを受信しない場合に通話を終了することができます。 Lync Server の要素のアクティブな通話に対する受信 RTCP メディアのチェックを無効にすることは、欠落したピアを検出するための重要なセーフガードをなくすことになるので、必要な場合にのみ実行する必要があります。 既定値は次のとおりです。True |
RTCPCallsOnHold |
省略可能 |
ブール値 |
このパラメーターでは、保留中で、どの方向にも流れることが予想されるメディア パケットがない通話に対して、RTCP パケットのトランク経由での送信を続行するかどうかを指定します。保留音が Lync Server クライアントまたはトランクで有効な場合、通話はアクティブと見なされ、このプロパティは無視されます。そのような状況では RTCPActiveCalls パラメーターを使用します。 Lync Server の要素のアクティブな通話に対する受信 RTCP メディアのチェックを無効にすることは、欠落したピアを検出するための重要なセーフガードをなくすことになるので、必要な場合にのみ実行する必要があります。 既定値は次のとおりです。True |
SipResponseCodeTranslationRulesList |
省略可能 |
PSListModifier |
PSTN ゲートウェイ、IP-PBX、サービス プロバイダーの SBC から受信した応答コードに適用する SIP 応答コード変換ルールの一覧。これらのルールにより、管理者はトランク経由で受信した 400 から 699 の間の値の SIP 応答コードを、Lync Server とより整合性のある新しい値にマップできます。 このコマンドレットで、この一覧およびそれに対応するルールを直接作成することもできます。ただし、SIP 応答コード変換ルールを作成するには、New-CsSipResponseCodeTranslationRule コマンドレットを呼び出すことをお勧めします。そのコマンドレットを実行すると、ルールが作成され、対応するスコープを持つトランク構成に対して割り当てられます。 |
SRTPMode |
省略可能 |
SRTPMode |
このパラメーター値で、仲介サーバー と、PSTN ゲートウェイ、IP-PBX、またはサービス プロバイダーの SBC のいずれかとの間のメディア トラフィックを保護する SRTP のサポート レベルを決定します。メディア バイパスの場合、この値はメディア構成の EncryptionLevel 設定と互換性を持つ必要があります。メディア構成は、New-CsMediaConfiguration コマンドレットおよび Set-CsMediaConfiguration コマンドレットを使用して設定します。 有効な値は次のとおりです。 - Required:SRTP 暗号化を使用する必要があります。 - Optional:サービス プロバイダーがサポートしている場合、SRTP を使用します。 - NotSupported:SRTP 暗号化はサポートされていないため、使用されません。 注: SRTPMode はゲートウェイがトランスポート層セキュリティ (TLS) を使用するように構成されている場合にのみ使用されます。ゲートウェイがトランスポートとして伝送制御プロトコル (TCP) を使用して構成されている場合、SRTPMode は内部的に NotSupported に設定されます。 既定値は次のとおりです。必須 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration オブジェクト。トランク構成オブジェクトのパイプライン処理された入力を受け入れます。
戻り値の種類
このコマンドレッには戻り値はありません。Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration 型のオブジェクトが変更されます。
例
-------------------------- 例 1 ------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True
この例では、メディア バイパスを有効にするように、site:Redmond という Identity を持つトランク構成を変更しています。EnableBypass パラメーターに値 $True を割り当てることで、メディア バイパスを有効にしています。この構成の残りのプロパティには、既存の値が保持されます。
-------------------------- 例 2 ------------------------
Set-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Translation '$1'
この例では、site:Redmond という Identity を持つトランク構成に定義されている発信変換ルールを変更しています。この変更を行うために、実際には Set-CsTrunkConfiguration コマンドレットは呼び出していません。Set-CsOutboundTranslationRule を使用して行った変更が、発信変換ルールの Identity のスコープ部分と一致する Identity を持つトランク構成に自動的に反映されています。
-------------------------- 例 3 ------------------------
Get-CsTrunkConfiguration -Filter site:* | Set-CsTrunkConfiguration -SRTPMode "Optional"
例 3 では、サイト スコープで定義されているすべてのトランク構成の SRTPMode を省略可能に設定しています。コマンドの最初の部分は Get-CsTrunkConfiguration コマンドレットの呼び出しで、Filter パラメーターを使用して site: で始まる Identity を持つすべてのトランク構成 (つまり、サイト レベルで定義されているすべてのトランク構成) を取得しています。この構成のコレクションを Set-CsTrunkConfiguration コマンドレットにパイプ処理して、それぞれの SRTPMode プロパティを省略可能に設定しています。
-------------------------- 例 4 ------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnablePIDFLOSupport $True
例 4 では、PIDF-LO サポートを有効にするように、site:Redmond という Identity を持つトランク構成を変更しています。既定では、EnablePIDFLOSupport パラメーターは False です。この例では、このパラメーターの値を True に設定し、緊急電話用の場所サポートを有効にしています。発信ルーティング アプリケーションによって場所情報がトランクに送信されるようにするには、EnablePIDFLOSupport を True に設定する必要があります。