다음을 통해 공유

  • 아티클

Set-CsProxyConfiguration

 

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

기존 프록시 서버 구성 설정 컬렉션을 수정합니다.

구문

Set-CsProxyConfiguration [-Identity <XdsIdentity>] [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <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>]]

Set-CsProxyConfiguration [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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를 설치하면 글로벌 프록시 서버 구성 설정 컬렉션이 자동으로 만들어집니다. 또한 언급한 바와 같이 서비스 범위에서 추가 컬렉션을 만들 수도 있습니다.

Set-CsProxyConfiguration cmdlet을 사용하면 기존 프록시 서버 구성 설정 컬렉션의 속성 값을 수정할 수 있습니다.

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

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

매개 변수

매개 변수 필수 유형 설명

Identity

필수

Xds ID

수정할 프록시 서버 구성 설정의 고유 식별자입니다. 글로벌 설정을 수정하려면 -Identity global 구문을 사용합니다. 서비스 범위에서 구성된 설정을 수정하려면 -Identity "service: EdgeServer:atl-edge-001.litwareinc.com"과 유사한 구문을 사용합니다.

이 매개 변수를 포함하지 않으면 Set-CsProxyConfiguration에서 자동으로 글로벌 설정을 수정합니다.

Instance

선택

ProxySettings 개체

개별 매개 변수 값을 설정하는 대신 cmdlet에 개체에 대한 참조를 전달할 수 있습니다.

AcceptClientCompression

선택

부울

True(기본값)로 설정하면 프록시 서버가 클라이언트 끝점에서 들어오는 모든 압축 요청을 수락합니다.

AcceptServerCompression

선택

부울

True(기본값)로 설정하면 프록시 서버가 다른 서버에서 들어오는 모든 압축 요청을 수락합니다.

DisableNTLMFor2010AndLaterClients

선택

부울

True로 설정하면 Microsoft Lync 2010에서 로그온하는 사용자가 인증을 위해 Kerberos 프로토콜을 사용해야 합니다. 기본값은 False입니다.

DNSCacheRecordCount

선택

정수

DNS 레코드 캐시에 유지할 수 있는 최대 레코드 수입니다. 기본값은 30000입니다.

EnableWhiteSpaceKeepAlive

선택

부울

True(기본값)로 설정하면 프록시 서버에서 클라이언트가 연결이 활성 상태임을 표시하기 위해 주기적으로 "공백 메시지"(내용이 없는 빈 메시지)를 보낼 것으로 예상합니다.

MaxClientCompressionCount

선택

정수

한 시점에 압축할 수 있는 클라이언트와 서버 간 연결의 최대 개수를 나타냅니다. 이 제한을 초과하면 연결이 압축되지 않습니다. 압축 수는 0에서 65535(포함) 사이의 정수 값으로 설정할 수 있습니다. 기본값은 15000입니다.

MaxClientMessageBodySizeKB

선택

정수

클라이언트 끝점에서 보내는 메시지 본문의 최대 허용 크기(킬로바이트)입니다. 기본값은 128입니다. 이는 본문 크기가 128KB보다 큰 메시지는 거부됨을 의미합니다. 클라이언트 메시지 본문 크기는 64에서 256(포함) 사이의 정수 값으로 설정할 수 있습니다.

MaxServerCompressionCount

선택

정수

한 시점에 압축할 수 있는 서버 간 연결의 최대 개수를 나타냅니다. 이 제한을 초과하면 연결이 압축되지 않습니다. 서버 압축 수는 0에서 65535(포함) 사이의 정수 값으로 설정할 수 있습니다. 기본값은 1024입니다.

MaxServerMessageBodySizeKB

선택

정수

다른 서버에서 보내는 메시지 본문의 최대 허용 크기(킬로바이트)입니다. 기본값은 5000로, 본문 크기가 5000KB보다 큰 메시지는 거부됩니다. 서버 메시지 본문 크기는 1000에서 20000(포함) 사이의 정수 값으로 설정할 수 있습니다.

OutgoingTLSCount

선택

정수

각 내부 서버에 사용할 수 있는 최대 TLS(전송 계층 보안) 연결 수를 지정합니다. TLS 연결의 최소 개수는 1개이고 최대 개수는 4개입니다. 기본적으로 OutgoingTlsCount는 4로 설정되어 있습니다.

Realm

선택

SipProxy 개체

보안 자격 증명이 기본 프록시 서버 영역(SIP 통신 서비스)에서 처리되는지, 아니면 사용자 지정 영역에서 처리되는지를 나타냅니다. New-CsSipProxyCustom cmdlet을 사용하여 사용자 지정 영역을 지정하고 만들어야 합니다.

RequestServerCompression

선택

부울

True(기본값)로 설정하면 프록시 서버가 다른 서버로 보내는 모든 연결에서 압축을 사용하도록 요청합니다.

TreatAllClientsAsRemote

선택

부울

True로 설정된 경우 모든 클라이언트 연결이 에지 서버를 통과하는 외부 연결인 것처럼 프록시 서버가 작동합니다. 기본값은 False입니다.

UseCertificateForClientToProxyAuth

선택

부울

True(기본값)로 설정하면 클라이언트 끝점에서 인증을 위해 인증서를 사용할 수 있습니다.

UseKerberosForClientToProxyAuth

선택

부울

True(기본값)로 설정하면 클라이언트 끝점에서 인증을 위해 Kerberos 프로토콜을 사용할 수 있습니다. Kerberos는 NTLM보다 안전한 프로토콜이지만 클라이언트와 서버가 서로 다른 도메인에 속해 있는 경우에는 Kerberos를 사용할 수 없습니다.

UseNtlmForClientToProxyAuth

선택

부울

True(기본값)로 설정하면 클라이언트 끝점에서 인증을 위해 NTLM 프로토콜을 사용할 수 있습니다. NTLM은 Kerberos보다 안전하지 않은 프로토콜이지만 클라이언트가 서버와 서로 다른 도메인에 속해 있는 경우에 사용할 수 있습니다. 이는 Kerberos 인증에는 해당되지 않습니다.

Force

선택

스위치 매개 변수

명령을 실행할 때 발생할 수 있는 심각하지 않은 오류 메시지를 표시하지 않습니다.

WhatIf

선택

스위치 매개 변수

명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.

Confirm

선택

스위치 매개 변수

명령을 실행하기 전에 확인 메시지를 표시합니다.

입력 형식

Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings 개체입니다. Set-CsProxyConfiguration은 프록시 설정 개체의 파이프라인된 인스턴스를 허용합니다.

반환 형식

Set-CsProxyConfiguration은 값이나 개체를 반환하지 않습니다. 대신 이 cmdlet은 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings 개체의 인스턴스를 구성합니다.

예제

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

Set-CsProxyConfiguration -Identity service:EdgeServer:atl-edge-001.litwareinc.com -AcceptServerCompression $True

예제 1에서는 Identity가 service:EdgeServer:atl-edge-001.litwareinc.com인 프록시 구성 설정을 서버 압축을 허용하도록 수정합니다. 이 작업을 수행하기 위해 Set-CsProxyConfiguration 및 AcceptServerCompression 매개 변수를 호출하고 매개 변수 값을 True로 설정합니다.

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

Get-CsProxyConfiguration | Where-Object {$_.AcceptServerCompression -eq $True} | Set-CsProxyConfiguration -AcceptClientCompression $True

위 명령은 서버 압축을 허용하는 모든 프록시 구성 설정을 찾은 다음 클라이언트 압축도 허용하도록 이러한 설정을 수정합니다. 먼저 조직에서 사용 중인 모든 프록시 설정 컬렉션을 반환하기 위해 Get-CsProxyConfiguration이 매개 변수 없이 호출됩니다. 이 컬렉션은 AcceptServerCompression 속성이 True와 같은 설정만 선택하는 Where-Object cmdlet에 파이프됩니다. 그런 다음 필터링된 컬렉션은 컬렉션의 각 항목에 대해 AcceptClientCompression 속성을 True로 설정하는 Set-CsProxyConfiguration에 파이프됩니다.

-------------------------- 예제 3 --------------------------

Get-CsProxyConfiguration -Filter service:* | Set-CsProxyConfiguration -UseNtlmForClientToProxyAuth $False

예제 3에서는 서비스 범위에서 구성된 모든 프록시 설정을 수정하는 방법을 보여 줍니다. 이 작업을 수행하기 위해 먼저 Get-CsProxyConfiguration이 호출되고 Filter 매개 변수가 포함됩니다. 필터 값 "service:*"는 Identity가 문자열 값 "service:"로 시작하는 설정만 반환되도록 합니다. 그런 다음 필터링된 컬렉션은 컬렉션의 각 항목에 대해 UseNtlmForClientToProxyAuth 속성을 False로 설정하는 Set-CsProxyConfiguration에 파이프됩니다.