New-CsTrunkConfiguration
마지막으로 수정된 항목: 2012-03-27
서비스 공급자의 PSTN 게이트웨이, IP-PBX(Public Branch Exchange) 또는 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>]]
자세한 정보
이 cmdlet을 사용하여 PSTN 게이트웨이 엔터티에 적용되는 새 트렁크 구성을 만들 수 있습니다. 각 구성은 PSTN 게이트웨이, IP-PBX 또는 SBC와 같은 서비스 공급자 쪽 트렁크 피어 엔터티에 대한 특정 설정을 포함합니다. 이러한 설정은 이 트렁크에서 미디어 우회를 사용하도록 설정할지 여부, 특정 상황에서 RTCP(Real-time Transmission Control Protocol) 패킷을 보낼지 여부, SRTP(Secure Real-Time Protocol) 암호화를 요구할지 여부 등을 구성합니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 New-CsTrunkConfiguration cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTrunkConfiguration"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
필수 |
Xds ID |
트렁크 구성 범위를 포함하는 고유 식별자입니다. 트렁크 구성 범위는 사이트 범위이거나 PSTN 게이트웨이 서비스에 대한 서비스 범위일 수 있습니다. 글로벌 구성은 기본적으로 존재하며 제거하거나 다시 만들 수 없습니다. site:Redmond(사이트의 경우) 또는 PstnGateway:Redmond.litwareinc.com(서비스의 경우)을 예로 들 수 있습니다. |
ConcentratedTopology |
선택 |
부울 |
이 매개 변수 값은 알려진 미디어 종료 지점이 있는지 확인합니다. 알려진 미디어 종료 지점의 예로는 미디어 종료가 신호 종료의 IP와 동일한 PSTN 게이트웨이가 있습니다. 트렁크에 알려진 미디어 종료 지점이 없는 경우에는 이 값을 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 cmdlet을 사용합니다. 기본값: False |
EnableMobileTrunkSupport |
선택 |
부울 |
서비스 공급자가 이동 통신 회사인지 여부를 정의합니다. 기본값: False |
EnablePIDFLOSupport |
선택 |
부울 |
PIDF-LO(Presence Information Data Format Location Object)가 포함된 응급 통화를 지정된 게이트웨이를 통해 경로 지정할지 여부를 정의합니다. 응급 통화를 특정 응급 서비스 공급자로 경로 지정하려면 이 매개 변수를 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 |
선택 |
PS 목록 한정자 |
아웃바운드 경로 지정에서 처리하는 통화(PBX 또는 PSTN 대상으로 경로 지정되는 통화)에 적용되는 전화 번호 변환 규칙 컬렉션입니다. 이 cmdlet을 사용하여 이 목록과 이러한 규칙을 직접 만들 수 있지만 규칙을 만들어 범위가 일치하는 트렁크 구성에 할당하는 New-CsOutboundTranslationRule cmdlet을 사용하여 아웃바운드 변환 규칙을 만드는 것이 좋습니다. |
RemovePlusFromUri |
선택 |
부울 |
이 매개 변수를 True로 설정하면 중재 서버가 URI(Uniform Resource Identifier)에서 앞에 오는 더하기 기호(+)를 제거한 후 서비스 공급자에게 URI를 전송합니다. 기본값: False |
RTCPActiveCalls |
선택 |
부울 |
이 매개 변수는 서비스 공급자 쪽 PSTN 게이트웨이, IP-PBX 또는 SBC에서 활성 통화에 대해 RTCP 패킷을 전송할지 여부를 결정합니다. 여기서 활성 통화란 미디어가 하나 이상의 방향으로 흐르도록 허용되는 통화를 의미합니다. RTCPActiveCalls를 True로 설정하면 RTCP 패킷을 30초 이상 받지 않은 경우 중재 서버 또는 Lync Server 클라이언트에서 통화를 종료할 수 있습니다. Lync Server 요소에서 활성 통화에 대해 수신된 RTCP 미디어를 확인하지 않도록 설정하면 연결이 끊긴 피어를 검색하는 중요한 안전 장치가 제거되므로 이 설정은 필요한 경우에만 수행해야 합니다. 기본값: True |
RTCPCallsOnHold |
선택 |
부울 |
이 매개 변수는 대기 상태에 놓여 있고 미디어 패킷이 어느 방향으로도 흐르지 않는 통화에 대해 트렁크를 통해 RTCP 패킷을 계속 전송할지 여부를 결정합니다. Lync Server 클라이언트 또는 트렁크에서 대기 음악을 사용하는 경우에는 통화가 활성 상태인 것으로 간주되며 이 속성이 무시됩니다. 이러한 상황에서는 RTCPActiveCalls 매개 변수를 사용해야 합니다. Lync Server 요소에서 활성 통화에 대해 수신된 RTCP 미디어를 확인하지 않도록 설정하면 연결이 끊긴 피어를 검색하는 중요한 안전 장치가 제거되므로 이 설정은 필요한 경우에만 수행해야 합니다. 기본값: True |
SipResponseCodeTranslationRulesList |
선택 |
PS 목록 한정자 |
서비스 공급자 쪽 PSTN 게이트웨이, IP-PBX 또는 SBC에서 받은 응답 코드에 적용되는 SIP 응답 코드 변환 규칙 목록입니다. 이러한 규칙을 통해 관리자는 값이 400에서 699 사이이고 트렁크를 통해 수신된 SIP 응답 코드를 Lync Server와 보다 일치하는 새 값에 매핑할 수 있습니다. 이 cmdlet을 사용하여 이 목록과 해당 규칙을 직접 만들 수 있지만 New-CsSipResponseCodeTranslationRule cmdlet을 호출하여 SIP 응답 코드 변환 규칙을 만드는 것이 좋습니다. 이 cmdlet은 규칙을 만들어 범위가 일치하는 트렁크 구성에 할당합니다. |
SRTPMode |
선택 |
SRTP 모드 |
이 매개 변수 값에 따라 중재 서버와 서비스 공급자 쪽 PSTN 게이트웨이, IP-PBX 또는 SBC 간의 미디어 트래픽을 보호하는 SRTP에 대한 지원 수준이 결정됩니다. 미디어 우회의 경우 이 값은 미디어 구성의 EncryptionLevel 설정과 호환되어야 합니다. 미디어 구성은 New-CsMediaConfiguration 및 Set-CsMediaConfiguration cmdlet을 사용하여 설정합니다. 유효한 값: - Required: SRTP 암호화를 사용해야 합니다. - Optional: 게이트웨이가 지원하는 경우 SRTP가 사용됩니다. - NotSupported: SRTP 암호화가 지원되지 않으므로 사용되지 않습니다. 참고: SRTPMode는 게이트웨이가 TLS(전송 계층 보안)를 사용하도록 구성된 경우에만 사용됩니다. 게이트웨이가 TCP(Transmission Control Protocol)를 전송 프로토콜로 사용하여 구성된 경우 SRTPMode는 내부적으로 NotSupported로 설정됩니다. 기본값: 필수 |
Force |
선택 |
스위치 매개 변수 |
변경하기 전에 표시되는 확인 메시지를 표시하지 않습니다. |
InMemory |
선택 |
스위치 매개 변수 |
개체를 실제로 영구 변경 사항으로 커밋하지 않고 개체 참조를 만듭니다. 이 매개 변수와 함께 호출된 이 cmdlet의 결과를 변수로 할당하면 개체 참조의 속성을 변경한 후 이 cmdlet과 일치하는 Set- cmdlet을 호출하여 해당 변경 사항을 커밋할 수 있습니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
없음.
반환 형식
Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration 개체 유형을 만듭니다.
예제
-------------------------- 예제 1 --------------------------
New-CsTrunkConfiguration -Identity site:Redmond
이 예제에서는 ID가 site:Redmond인 새 트렁크 구성을 만듭니다. 이 새 구성의 나머지 속성은 기본값으로 채워집니다.
-------------------------- 예제 2 --------------------------
New-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True
이 예제에서는 ID가 site:Redmond인 새 트렁크 구성을 만들고 미디어 우회를 사용하도록 설정합니다. 미디어 우회를 사용하도록 설정하려면 EnableBypass 매개 변수에 $True 값을 할당합니다. 이 새 구성의 나머지 속성은 기본값으로 채워집니다.
-------------------------- 예제 3 --------------------------
New-CsTrunkConfiguration -Identity site:Redmond
New-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Pattern '^\+(\d{8})$' -Translation '9$1'
이 예제에서는 ID가 site:Redmond인 새 트렁크 구성을 만든 다음 해당 트렁크에 새 아웃바운드 변환을 할당합니다. 예제의 첫째 줄은 New-CsTrunkConfiguration을 호출하여 기본 설정으로 새 트렁크 구성을 만듭니다. 둘째 줄은 New-CsOutboundTranslationRule cmdlet을 호출합니다. Identity에는 site:Redmond/OTR1 값이 할당되었습니다. ID의 앞 부분(site:Redmond)은 규칙이 적용되는 범위를 정의합니다. 이 범위는 새 트렁크 구성의 ID와 일치하므로 이 규칙은 해당 구성에 자동으로 적용됩니다. 범위 다음에는 슬래시(/)가 오고 그 다음 이 규칙의 고유 이름인 문자열이 옵니다. 범위당 규칙이 여러 개 일 수 있습니다. 그런 다음 Pattern 및 Translation 매개 변수에 값을 전달하여 이 규칙을 정의합니다.