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