New-CsProxyConfiguration

구문

New-CsProxyConfiguration -Identity <XdsIdentity> [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxClientCompressionCount <UInt32>] [-MaxClientMessageBodySizeKb <UInt32>] [-MaxServerCompressionCount <UInt32>] [-MaxServerMessageBodySizeKb <UInt32>] [-OutgoingTlsCount <UInt32>] [-Realm <IRealmChoice>] [-RequestServerCompression <$true | $false>] [-TreatAllClientsAsRemote <$true | $false>] [-UseCertificateForClientToProxyAuth <$true | $false>] [-UseKerberosForClientToProxyAuth <$true | $false>] [-UseNtlmForClientToProxyAuth <$true | $false>] [-WhatIf [<SwitchParameter>]]

자세한 정보

Microsoft Lync Server 2010을 사용하여 프록시 서버 구성 설정을 통해 프록시 서버를 관리할 수 있습니다. 글로벌 범위 및 서비스 범위(에지 서버 및 등록자 서비스에만 해당)에서 적용할 수 있는 이러한 설정을 통해 클라이언트 끝점에서 사용할 수 있는 인증 프로토콜, 보내고 받는 프록시 서버 연결에 압축을 사용할지 여부 등을 제어할 수 있습니다. Lync Server 2010를 설치하면 글로벌 프록시 서버 구성 설정 컬렉션이 자동으로 만들어집니다. 앞서 말했듯이 서비스 범위에 추가 컬렉션을 만들 수도 있습니다. 이러한 새 컬렉션은 New-CsProxyConfiguration cmdlet을 사용하여 만듭니다.

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

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

매개 변수

입력 형식

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

반환 형식

New-CsProxyConfiguration은 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings 개체의 새 인스턴스를 만듭니다.

예제

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

New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -RequestServerCompression $True -MaxClientMessageBodySizeKb 256

위 명령은 EdgeServer:atl-edge-001.litwareinc.com 서비스의 새 프록시 구성 설정 컬렉션을 만듭니다. 이러한 새 설정은 모든 기본 프록시 서버 속성 값을 사용합니다. 단, True로 설정된 RequestServerCompression 및 256으로 설정된 MaxClientMessageBodySizeKb는 예외입니다. EdgeServer:atl-edge-001.litwareinc.com 서비스에 대해 프록시 서버 설정이 이미 구성되어 있는 경우 이 명령이 실패합니다.

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

$x = New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -InMemory
$x.RequestServerCompression = $True 
$x.MaxClientMessageBodySizeKb = 256
Set-CsProxyConfiguration -Instance $x

예제 2에 표시된 명령은 처음에 메모리에만 있는 프록시 서버 설정 컬렉션을 만드는 방법을 보여 줍니다. 이를 수행하기 위해 첫째 명령이 New-CsProxyConfiguration을 설정의 ID를 지정하는 Identity 및 새 설정을 메모리에만 만들도록 지정하는 InMemory의 두 매개 변수와 함께 호출합니다. 결과 개체는 $x 변수에 저장됩니다.

이러한 가상 설정이 만들어진 후에는 두 번째와 세 번째 명령을 사용하여 RequestServerCompression 속성 및 MaxClientMessageBodySizeKb 속성의 값을 각각 수정합니다. 마지막으로 넷째 명령을 사용하여 가상 프록시 서버 구성 설정을 EdgeServer:atl-edge-001.litwareinc.com 서비스에 적용되는 실제 설정 컬렉션으로 변환합니다. 이 마지막 명령은 필수입니다. Set-CsProxyConfiguration을 호출하지 않으면 EdgeServer:atl-edge-001.litwareinc.com에 아무런 설정이 적용되지 않으며 Windows PowerShell 세션을 종료하거나 $x 변수를 삭제하자 마자 가상 설정이 사라집니다.

참고 항목

기타 리소스

Get-CsProxyConfiguration
Remove-CsProxyConfiguration
Set-CsProxyConfiguration