New-CsSipProxyRealm
마지막으로 수정된 항목: 2012-03-27
프록시 구성 설정 컬렉션에 기본 영역(SIP 통신 서비스)을 할당하는 데 사용됩니다. 영역(보호 도메인이라고도 함)은 로그온하는 동안 사용자 자격 증명을 인증하는 데 사용됩니다.
구문
New-CsSipProxyRealm -RealmChoice <IRealmChoice>
자세한 정보
프록시 서버를 사용하면 내부 네트워크 외부의 사용자가 내부 네트워크의 리소스에 액세스할 수 있습니다. 각 프록시 서버는 영역과 연결되어야 합니다. 영역(보호 도메인이라고도 함)은 사용자의 로그온 자격 증명을 처리해야 하는 위치를 나타냅니다. 기본적으로 Microsoft Lync Server 2010에서는 SIP 통신 서비스를 기본 영역으로 사용하지만 프록시 서버에 사용되는 영역을 변경할 수 있습니다. New-CsSipProxyUseDefault 및 New-CsSipProxyCustom cmdlet을 사용하여 프록시 서버에서 사용하는 영역을 변경할 수 있습니다. New-CsSipProxyRealm을 사용하여 영역을 변경할 수도 있습니다. 하지만 이 cmdlet에는 추가 단계가 필요하므로 프록시 서버에서 사용하는 영역을 변경해야 하는 경우 다른 두 프록시 cmdlet을 사용하는 경우가 많습니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 New-CsSipProxyRealm cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSipProxyRealm"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
RealmChoice |
필수 |
SipProxy.IRealmChoice 개체 |
프록시 서버에서 사용할 영역을 나타내는 개체입니다. RealmChoice는 New-CsSipProxyUseDefault 또는 New-CsSipProxyCustom cmdlet을 사용하여 만들어야 합니다. |
입력 형식
없음. New-CsSipProxyRealm은 파이프라인된 입력을 허용하지 않습니다.
반환 형식
New-CsSipProxyRealm은 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Realm 개체의 새 인스턴스를 만듭니다.
예제
-------------------------- 예제 1 --------------------------
$x = New-CsSipProxyUseDefault
$y = New-CsSipProxyRealm -RealmChoice $x
예제 1에 표시된 명령은 $y 변수에 기본 영역(SIP Communications Service)을 할당합니다. 이 작업을 수행하기 위해 첫 번째 명령은 New-CsSipProxyUseDefault를 호출하여 SipProxy.UseDefault 개체를 만듭니다. 이 개체는 $x 변수에 저장됩니다.
두 번째 명령에서는 $x를 New-CsSipProxyRealm 및 RealmChoice 매개 변수의 값으로 사용합니다. 그러면 $y 변수에 저장되는 새 프록시 영역 개체가 만들어집니다.
-------------------------- 예제 2 --------------------------
$x = New-CsSipProxyCustom -CustomValue "Litwareinc Communications Service"
$y = New-CsSipProxyRealm -RealmChoice $x
예제 2에 표시된 명령은 $y 변수에 사용자 지정 영역(Litwareinc Communications Service)을 할당합니다. 이 작업을 수행하기 위해 첫 번째 명령은 New-CsSipProxyCustom을 호출하여 SipProxy.Custom 개체를 만듭니다. CustomValue Litwareinc Communications Service를 사용하는 이 개체는 $x 변수에 저장됩니다.
두 번째 명령에서는 New-CsSipProxyRealm 및 –RealmChoice 매개 변수와 함께 $x를 사용하여 새 사용자 지정 영역 개체를 만듭니다.