Set-CsWebServiceConfiguration
마지막으로 수정된 항목: 2012-04-23
웹 서비스 구성 설정의 기존 컬렉션을 수정합니다.
구문
Set-CsWebServiceConfiguration [-Identity <XdsIdentity>] [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-MACResolverUrl <String>] [-MaxCSRKeySize <UInt64>] [-MaxGroupSizeToExpand <UInt32>] [-MaxValidityPeriodHours <UInt64>] [-MinCSRKeySize <UInt64>] [-MinValidityPeriodHours <UInt64>] [-SecondaryLocationSourceUrl <String>] [-ShowDownloadCommunicatorAttendeeLink <$true | $false>] [-ShowJoinUsingLegacyClientLink <$true | $false>] [-TrustedCACerts <PSListModifier>] [-UseCertificateAuth <$true | $false>] [-UsePinAuth <$true | $false>] [-UseWindowsAuth <None | Negotiate | NTLM>] [-WhatIf [<SwitchParameter>]]
Set-CsWebServiceConfiguration [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-Instance <PSObject>] [-MACResolverUrl <String>] [-MaxCSRKeySize <UInt64>] [-MaxGroupSizeToExpand <UInt32>] [-MaxValidityPeriodHours <UInt64>] [-MinCSRKeySize <UInt64>] [-MinValidityPeriodHours <UInt64>] [-SecondaryLocationSourceUrl <String>] [-ShowDownloadCommunicatorAttendeeLink <$true | $false>] [-ShowJoinUsingLegacyClientLink <$true | $false>] [-TrustedCACerts <PSListModifier>] [-UseCertificateAuth <$true | $false>] [-UsePinAuth <$true | $false>] [-UseWindowsAuth <None | Negotiate | NTLM>] [-WhatIf [<SwitchParameter>]]
자세한 정보
많은 Microsoft Lync Server 2010 구성 요소가 웹에 기반을 두고 있습니다. 이러한 구성 요소는 웹 서비스 또는 웹 페이지를 사용하여 작업을 수행합니다. 예를 들어 사용자는 주소록에서 새 연락처를 검색하거나 그룹 확장을 사용하여 메일 그룹의 개별 구성원을 볼 때 웹 서비스를 사용합니다. 마찬가지로 전화 접속 회의부터 Microsoft Lync Server 2010 제어판에 이르는 구성 요소는 Lync Server 2010과 사용자 간의 인터페이스로 웹 페이지를 사용합니다.
CsWebServiceConfiguration cmdlet을 사용하면 관리자가 조직 전체의 웹 서비스 구성 설정을 관리할 수 있습니다. 여기에는 그룹 확장, 인증서 설정 및 허용되는 인증 방법 관리가 포함됩니다. 전역, 사이트 및 서비스(웹 서비스에만 해당) 범위에 여러 설정을 구성할 수 있으므로 다양한 사용자 및 위치에 대해 웹 서비스 기능을 사용자 지정할 수 있습니다. CsWebServiceConfiguration cmdlet(Get-CsWebServiceConfiguration, New-CsWebServiceConfiguration, Remove-CsWebServiceConfiguration 및 Set-CsWebServiceConfiguration)을 사용하면 관리자가 조직 전체의 웹 서비스 구성 설정을 관리할 수 있습니다. 여기에는 그룹 확장, 인증서 설정 및 허용되는 인증 방법 관리가 포함됩니다. 전역, 사이트 및 서비스(웹 서비스에만 해당) 범위에 여러 설정을 구성할 수 있으므로 다양한 사용자 및 위치에 대해 웹 서비스 기능을 사용자 지정할 수 있습니다.
사용자 지정 설정(예: 인증서에 대한 사용자 지정 유효성 기간)은 새 웹 서비스 구성 설정 컬렉션을 생성할 때 지정할 수 있습니다. 또는 Set-CsWebServiceConfiguration cmdlet을 사용하여 기존 컬렉션의 속성 값을 수정할 수 있습니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 Set-CsWebServiceConfiguration cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsWebServiceConfiguration"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
필수 |
Xds ID |
수정할 웹 서비스 구성 설정의 고유 식별자입니다. 사이트 범위에서 구성된 설정을 수정하려면 -Identity "site:Redmond"와 유사한 구문을 사용합니다. 서비스 범위에서 구성된 설정을 수정하려면 -Identity "service:WebServer:atl-cs-001.litwareinc.com"과 유사한 구문을 사용합니다. 글로벌 범위에서 구성된 설정을 수정하려면 -identity global과 같은 구문을 사용할 수 있습니다. Identity 매개 변수를 사용하지 않으면 Set-CsWebServiceConfiguration이 글로벌 컬렉션을 자동으로 수정합니다. |
Instance |
필수 |
WebServiceSettings 개체 |
개별 매개 변수 값을 설정하는 대신 cmdlet에 개체에 대한 참조를 전달할 수 있습니다. |
AllowAnonymousAccessToLWAConference |
선택 |
부울 |
True로 설정하면 익명 사용자가 LWA(Lync Web App) 회의에 참가할 수 있습니다. |
CASigningKeyLength |
선택 |
정수 |
CA(인증 기관)가 디지털 인증서에 서명하는 데 사용한 개인 키인 CA 서명 키의 크기를 설정합니다. 서명 키 길이는 2048-16384바이트 사이의 정수 값으로 설정할 수 있습니다. 기본값은 2048입니다. |
DefaultValidityPeriodHours |
선택 |
정수 |
인증서 인증을 사용할 경우 클라이언트는 인증서가 유효성을 유지하는 기간(시간 단위)을 요청할 수 있습니다. DefaultValidityPeriodHours는 클라이언트가 사용자 지정 유효성 기간을 요청하지 않는 경우 인증서가 유효성을 유지하는 시간을 나타냅니다. DefaultValidityPeriodHours는 8-8760시간(365일) 사이의 정수 값입니다. 기본값은 4320(180일)입니다. |
EnableCertChainDownload |
선택 |
부울 |
True로 설정된 경우 인증 인증서로 표시되는 서버에서 해당 인증서의 인증서 체인을 다운로드합니다. 인증서 체인은 개별 인증서의 발급 CA를 추적합니다. 인증서의 CA를 신뢰할 수 있게 되기 전에는 인증서가 인증에 사용되지 않습니다. |
EnableGroupExpansion |
선택 |
True로 설정된 경우 Microsoft Lync 2010에서 그룹 확장을 사용할 수 없게 됩니다. 그룹 확장을 통해 사용자는 메일 그룹을 연락처로 구성한 다음 해당 그룹을 "확장"할 수 있습니다. 그룹이 확장되면 사용자는 그룹의 개별 구성원과 구성원의 현재 상태 정보를 확인할 수 있습니다. |
|
InferCertChainFromSSL |
선택 |
부울 |
True로 설정된 경우 서버는 SSL(Secure Sockets Layer) 프로토콜에 포함된 인증서 정보를 사용하여 발급 CA를 확인합니다. 인증서의 CA를 신뢰할 수 있게 되기 전에는 인증서가 인증에 사용되지 않습니다. |
MACResolverUrl |
선택 |
문자열 |
MAC(미디어 액세스 제어) 확인을 수행할 수 있는 웹 서비스의 URL입니다. MAC 확인에서는 IP 주소를 가져오고 IP 주소와 연결된 네트워크 카드의 MAC 주소를 확인합니다. |
MaxCSRKeySize |
선택 |
정수 |
CSR(인증서 서명 요청) 키의 최대 크기를 설정합니다. CSR은 디지털 인증서에 적용하기 위해 응용 프로그램에서 CA로 전송된 메시지입니다. CSR 키의 최대 크기는 1024-16384바이트의 정수 값으로 설정할 수 있습니다. 기본값은 16384입니다. |
MaxGroupSizeToExpand |
선택 |
정수 |
그룹이 확장될 때 표시되는 최대 사용자 수를 나타냅니다. 예를 들어, MaxGroupSizeToExpand를 75로 설정하는 경우 그룹이 확장될 때 처음 75명의 그룹 구성원만 표시됩니다. MaxGroupSizeToExpand는 1-1000(포함) 사이의 정수 값으로 설정할 수 있습니다. 기본값은 100입니다. |
MaxValidityPeriodHours |
선택 |
정수 |
인증서 인증을 사용할 경우 클라이언트는 인증서가 유효성을 유지하는 기간(시간 단위)을 요청할 수 있습니다. MaxValidityPeriodHours는 클라이언트가 요청할 수 있는 최대 시간을 나타냅니다. MaxValidityPeriodHours는 8-8760시간(365일) 사이의 정수 값입니다. 기본값은 8760입니다. |
MinCSRKeySize |
선택 |
정수 |
CSR(인증서 서명 요청) 키의 최소 크기를 설정합니다. 최소 크기는 1024-16384바이트 사이의 정수 값으로 설정할 수 있습니다. 기본값은 16384입니다. |
MinValidityPeriodHours |
선택 |
정수 |
인증서 인증을 사용할 경우 클라이언트는 인증서가 유효성을 유지하는 기간(시간 단위)을 요청할 수 있습니다. MinValidityPeriodHours는 클라이언트가 요청할 수 있는 최소 시간을 나타냅니다. MinValidityPeriodHours는 8-4320시간(180일) 사이의 정수 값입니다. 기본값은 8입니다. |
SecondaryLocationSourceUrl |
선택 |
문자열 |
위치 요청을 처리할 수 있는 웹 서비스의 URL입니다. 이 서비스는 위치 요청을 로컬에서 확인할 수 없는 경우에만 사용됩니다. |
ShowDownloadCommunicatorAttendeeLink |
선택 |
부울 |
True(기본값)로 설정하면 Lync 2010 이외의 클라이언트 응용 프로그램을 사용하여 모임에 참가하는 사용자에게 Lync 2010 Attendee를 다운로드할 수 있는 링크가 표시됩니다. |
ShowJoinUsingLegacyClientLink |
선택 |
부울 |
True로 설정하면 Lync 2010 이외의 클라이언트 응용 프로그램을 사용하여 모임에 참가하는 사용자에게 현재 클라이언트 응용 프로그램을 사용하여 모임에 참가할 수 있는 기회가 부여됩니다. 기본값은 False입니다. |
TrustedCACerts |
선택 |
인증서 컬렉션 |
웹 서버가 신뢰하는 인증서 체인을 나타내는 인증서 컬렉션입니다. 컬렉션에 추가할 새 인증서는 New-CsWebTrustedCACertificate cmdlet을 사용하여 만들어야 합니다. InferCertChainFromSSL 속성이 True로 설정된 경우에는 이 컬렉션이 사용되지 않습니다. |
UseCertificateAuth |
선택 |
부울 |
True(기본값)로 설정된 경우 인증서를 사용하여 클라이언트를 인증할 수 있습니다. 인증서 인증을 사용하지 않도록 설정하려면 이 값을 False로 설정합니다. |
UsePinAuth |
선택 |
부울 |
True(기본값)로 설정하면 클라이언트가 PIN(개인 ID 번호)을 사용하여 인증할 수 있습니다. PIN 인증을 사용하지 않도록 설정하려면 이 값을 False로 설정합니다. |
UseWindowsAuth |
선택 |
PS 목록 한정자 |
Windows 인증을 사용하여, 즉 Windows에 로그인할 때 사용한 것과 동일한 인증서를 사용하여 사용자를 인증하는 방법 및 인증할지 여부를 결정합니다. 사용할 수 있는 값은 다음과 같습니다. Negotiate – 적절한 인증 프로토콜(Kerberos 또는 NTLM)을 결정하기 위해 클라이언트 및 서버가 함께 작동합니다. NTLM – Windows 인증이 허용되지만 NTLM 프로토콜만 사용합니다. 없음 – Windows 인증이 허용되지 않습니다. |
Force |
선택 |
스위치 매개 변수 |
cmdlet을 실행할 때 나타날 수 있는 확인 프롬프트 또는 심각하지 않은 오류 메시지를 표시하지 않습니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings 개체입니다. Set-CsWebServiceConfiguration은 웹 서비스 설정 개체의 파이프라인된 입력을 허용합니다.
반환 형식
Set-CsWebServiceConfiguration은 값이나 개체를 반환하지 않습니다. 대신 이 cmdlet은 Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings 개체의 인스턴스를 구성합니다.
예제
-------------------------- 예제 1 ------------------------
Set-CsWebServiceConfiguration -Identity site:Redmond -EnableGroupExpansion $True
예제 1에서는 Redmond 사이트에 적용되는 웹 서비스 구성 설정의 그룹 확장을 활성화합니다(-Identity site:Redmond). 이 작업은 EnableGroupExpansion 속성을 포함하고 매개 변수 값을 True로 설정하여 수행됩니다.
-------------------------- 예제 2 ------------------------
Get-CsWebServiceConfiguration -Filter "site:*" | Set-CsWebServiceConfiguration -MaxValidityPeriodHours 16
예제 2에서는 사이트 범위에서 적용된 모든 웹 서비스 구성 설정의 최대 유효 기간이 16시간으로 변경됩니다. 이 작업을 수행하기 위해 Get-CsWebServiceConfiguration이 Filter 매개 변수와 함께 호출됩니다. 필터 값 "site:*"는 반환된 데이터를 ID가 "site:" 문자로 시작하는 설정으로 제한합니다. 그런 다음 이 컬렉션은 컬렉션의 각 항목을 가져오고 MaxValidityPeriodHours 속성을 16으로 변경하는 Set-CsWebServiceConfiguration에 파이프됩니다.
-------------------------- 예제 3 ------------------------
Get-CsWebServiceConfiguration | Where-Object {$_.EnableGroupExpansion -eq $True} | Set-CsWebServiceConfiguration -MaxGroupSizeToExpand 400
위 명령에서 그룹 확장 크기는 그룹 확장을 허용하는 웹 서비스 구성 설정의 각 컬렉션에 대해 400으로 설정됩니다. 이 작업을 수행하기 위해 매개 변수 없이 Get-CsWebServiceConfiguration을 호출합니다. 그러면 조직에서 사용되는 모든 웹 서비스 구성 설정의 컬렉션이 반환됩니다. 이 컬렉션은 EnableGroupExpansion 속성이 True와 같은 설정만 선택하는 Where-Object에 파이프됩니다. 그런 다음 이 필터링된 컬렉션은 컬렉션의 각 항목을 가져오고 MaxGroupSizeToExpand 속성 값을 400으로 설정하는 Set-CsWebServiceConfiguration에 파이프됩니다.
-------------------------- 예제 4 --------------------------
Set-CsWebServiceConfiguration -Identity global -ShowDownloadCommunicatorAttendeeLink $True
예제 4에 표시된 명령은 Lync 2010 이외의 클라이언트 응용 프로그램을 사용하여 모임에 참가하는 사용자에게 Lync 2010 Attendee 를 다운로드할 수 있는 사이트의 링크가 표시되도록 글로벌 웹 서비스 설정을 구성하는 방법을 보여 줍니다. 이 작업은 ShowDownloadCommunicatorAttendeeLink 매개 변수를 포함하고 매개 변수 값을 $True로 설정하여 수행됩니다.