Set-CsProxyConfiguration

구문

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"}

매개 변수

입력 형식

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에 파이프됩니다.

참고 항목

기타 리소스

Get-CsProxyConfiguration
New-CsProxyConfiguration
Remove-CsProxyConfiguration