다음을 통해 공유

  • 아티클

New-CsStaticRoute

 

마지막으로 수정된 항목: 2012-03-26

새 고정 전화 경로를 만듭니다.

구문

New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TLSRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>] [-TLSCertIssuer <String>] [-TLSCertSerialNumber <Byte[]>] [-UseDefaultCertificate <$true | $false>]

New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TCPRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>]

자세한 정보

SIP 메시지를 누군가에게 보내는 경우 이 메시지는 배달되기 전에 여러 서브넷과 네트워크를 통과해야 할 수 있습니다. 메시지가 거치는 이러한 길을 일반적으로 경로라고 합니다. 네트워킹에는 동적 경로와 고정 경로의 두 가지 유형의 경로가 있습니다. 동적 경로는 서버가 알고리즘을 사용하여 메시지를 전달해야 할 다음 위치(다음 홉)를 결정합니다. 고정 경로의 경우 메시지 경로는 시스템 관리자에 의해 미리 결정됩니다. 메시지가 서버에 수신되면 서버는 메시지 주소를 확인한 다음 관리자가 미리 구성한 다음 홉 서버로 메시지를 전달합니다. 고정 경로를 제대로 구성한 경우에는 제시간에 정확하게 메시지를 전달하고 서버에 대한 오버헤드를 최소화할 수 있습니다. 고정 경로의 단점은 네트워크 실패 시 메시지가 동적으로 다시 경로 지정되지 않는다는 것입니다.

새 고정 경로는 New-CsStaticRoute cmdlet을 사용하여 만듭니다. New-CsStaticRoute를 사용하여 경로를 만든 후에는 Set-CsStaticRoutingConfiguration cmdlet을 사용하여 경로 지정 구성 설정 컬렉션에 경로를 추가해야 합니다.

이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 New-CsStaticRoute cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsStaticRoute"}

매개 변수

매개 변수 필수 유형 설명

Destination

필수

문자열

경로에서 TLS(전송 계층 보안)를 전송 프로토콜로 사용하는 경우 Destination은 다음 홉 서버의 FQDN(정규화된 도메인 이름)입니다. 예: -Destination "atl-proxy-001.litwareinc.com"

경로에서 TCP(Transmission Control Protocol)를 전송 프로토콜로 사용하는 경우 Destination은 다음 홉 라우터의 IP 주소입니다. 예: -Destination "192.168.0.240"

MatchUri

필수

문자열

이 경로에서 처리된 메시지를 사용자에게 보낼지 여부를 결정하는 데 사용되는 FQDN 또는 도메인 접미사입니다. 예를 들어 FQDN "litwareinc.com"을 사용할 수 있습니다. 이 패턴은 SIP 주소가 도메인 이름 "litwareinc.com"으로 끝나는 모든 사용자와 일치합니다.

도메인의 자식 도메인을 일치시키려면 "*.litwareinc.com"과 같이 와일드카드 값을 사용할 수 있습니다. 해당 값은 "litwareinc.com" 접미사로 끝나는 모든 도메인과 일치합니다. 예: northamerica.litwareinc.com, asia.litwareinc.com, europe.litwareinc.com 등

Enabled

선택

부울

True로 설정하면 경로가 활성화되고, MatchURI 패턴과 일치하는 모든 메시지가 다음 홉 서버로 경로 지정됩니다. False로 설정하면 경로가 비활성화되고 메시지 경로 지정에 사용되지 않습니다. 기본값은 True입니다.

MatchOnlyPhoneUri

선택

부울

True로 설정하면 전화 URI(Uniform Resource identifier)로 보내는 메시지(예: sip:kenmmyer@litwareinc.com;user=phone)만 일치되고 경로 지정될 수 있습니다. False(기본값)로 설정하면 모든 메시지가 일치됩니다.

Port

필수

정수

SIP 경로 지정에 사용되는 포트 번호입니다. 예: -Port 7742.

ReplaceHostInRequestUri

선택

부울

True($True)로 설정하면 Request-URI의 호스트 부분이 다음 홉 서버의 주소로 바뀝니다. False(기본값)를 설정하면 Request-URI가 있는 그대로 사용됩니다. Request-URI는 요청(메시지)이 보내지는 사용자 또는 서비스의 URI를 나타냅니다. 기본값은 False입니다.

TCPRoute

선택

스위치 매개 변수

TCP(Transmission Control Protocol)를 새 경로의 전송 프로토콜로 구성합니다.

TLSCertIssuer

선택

문자열

고정 경로에서 사용할 인증서를 발급한 CA(인증 기관)의 이름입니다. TCP를 전송 프로토콜로 구성한 경우에는 이 매개 변수가 사용되지 않습니다.

TLSCertIssuer 매개 변수를 포함하는 경우 TLSCertSerialNumber 매개 변수도 사용해야 합니다.

TLSCertSerialNumber

선택

바이트 배열

고정 경로에서 사용할 TLS 인증서의 일련 번호입니다. 일련 번호는 바이트 배열로 전달되어야 합니다. 즉, 두 문자로 이루어진 값의 배열로 일련 번호를 전달해야 합니다. 예: -TLSCertSerialNumber 0x01, 0xA4, 0xD5, 0x67, 0x89

TCP를 전송 프로토콜로 구성한 경우에는 이 매개 변수가 사용되지 않습니다.

TLSCertSerialNumber 매개 변수를 포함하는 경우 TLSCertIssuer 매개 변수도 사용해야 합니다.

TLSRoute

선택

스위치 매개 변수

TLS를 새 경로의 전송 프로토콜로 구성합니다.

UseDefaultCertificate

선택

부울

기본 Lync Server 2010 인증서를 인증 인증서로 사용하도록 경로를 구성합니다. 기본 인증서를 사용하지 않으려면 TLSCertIssuer 및 TLSCertSerialNumber 매개 변수를 사용하여 다른 인증서를 지정해야 합니다.

기본 인증서를 보려면 다음 명령을 사용합니다.

Get-CsCertificate | Where-Object {$_.Use –eq "urn:certref:Default"}

입력 형식

없음. New-CsStaticRoute는 파이프라인된 입력을 허용하지 않습니다.

반환 형식

New-CsStaticRoute는 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Route 개체의 새 인스턴스를 만듭니다.

예제

-------------------------- 예제 1 ------------------------

$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "litwareinc.com" 

Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}

예제 1에 표시된 명령은 새 고정 경로를 만든 다음 글로벌 고정 경로 지정 구성 컬렉션에 해당 경로를 추가합니다. 이 작업을 수행하기 위해 첫 번째 명령은 New-CsStaticRoute를 사용하여 TCP를 전송 프로토콜로 사용하는 메모리 전용 경로를 만듭니다. 이 경로는 다음 홉 IP 주소인 192.168.0.100을 가리키고, 포트 8025를 사용하며, litwareinc.com 도메인의 모든 URI와 일치합니다. 결과 경로 개체는 변수 $x에 저장됩니다.

예제의 두 번째 명령은 글로벌 고정 경로 지정 구성 컬렉션에 새 경로를 추가합니다. 이 작업을 수행하기 위해 Set-CsStaticRoutingConfiguration을 Route 매개 변수와 함께 호출합니다. 매개 변수 값 @{Add=$x}는 $x에 저장된 경로 개체가 이미 글로벌 컬렉션에 있는 기존 경로 집합에 추가합니다.

-------------------------- 예제 2 ------------------------

$x = New-CsStaticRoute -TLSRoute -Destination "atl-proxy-001.litwareinc.com" -Port 8025 -MatchUri "*.litwareinc.com" -UseDefaultCertificate $True

Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}

예제 2에서는 TLS를 전송 프로토콜로 사용하는 새 고정 경로를 만든 다음 글로벌 고정 경로 지정 구성 컬렉션에 해당 경로를 추가하는 방법을 보여 줍니다. 이 작업을 수행하기 위해 예제의 첫 번째 명령은 New-CsStaticRoute를 사용하여 TLS를 전송 프로토콜로 사용하는 메모리 전용 경로를 만듭니다. 이 경로는 "atl-proxy-001.litwareinc.com"을 해당 대상으로 가리키고, 포트 8025를 사용하며, 도메인 접미사 "litwareinc.com"을 사용하는 URI를 일치시킵니다. 또한 변수 $x에 저장된 새 경로 개체는 기본 인증서를 인증에 사용합니다(-UseDefaultCertificate $True).

경로 개체가 만들어진 후 예제의 두 번째 명령은 글로벌 고정 경로 지정 구성 컬렉션에 새 경로를 추가합니다.