New-CsWebServiceConfiguration

구문

New-CsWebServiceConfiguration -Identity <XdsIdentity> [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-InMemory <SwitchParameter>] [-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을 사용하면 관리자가 조직 전체의 웹 서비스 구성 설정을 관리할 수 있습니다. 여기에는 그룹 확장, 인증서 설정 및 허용되는 인증 방법 관리가 포함됩니다. 전역, 사이트 및 서비스(웹 서비스에만 해당) 범위에 여러 설정을 구성할 수 있으므로 다양한 사용자 및 위치에 대해 웹 서비스 기능을 사용자 지정할 수 있습니다.

새 웹 서비스 구성 설정은 New-CsWebServiceConfiguration cmdlet을 사용하여 만듭니다. 이러한 설정은 사이트 또는 서비스 범위(웹 서비스에만 해당)에서만 만들 수 있으며 글로벌 범위에 새 컬렉션을 만들려고 하면 명령이 실패하게 됩니다. 마찬가지로 레드몬드 사이트 등에 새 컬렉션을 만들려고 할 때 해당 사이트가 웹 서비스 설정 컬렉션을 이미 호스트하는 경우 명령이 실패하게 됩니다.

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

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

매개 변수

입력 형식

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

반환 형식

New-CsWebServiceConfiguration은 Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings 개체의 새 인스턴스를 만듭니다.

예제

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

New-CsWebServiceConfiguration -Identity site:Redmond -EnableGroupExpansion $False -UseCertificateAuth $True

예제 1에 표시된 명령은 Redmond 사이트(-Identity site:Redmond)의 새로운 웹 서비스 구성 설정 컬렉션을 만듭니다. 이 예제에는 두 가지 선택적 매개 변수가 포함되어 있는데, 하나는 False($False)로 설정된 EnableGroupExpansion이고 다른 하나는 True($True)로 설정된 UseCertificateAuth입니다. 이러한 두 매개 변수는 각각 그룹 확장을 사용하지 않도록 설정하고 인증에 인증서를 사용하도록 설정하는 데 사용됩니다.

레드몬드 사이트에 대해 웹 서비스 구성 설정 컬렉션이 이미 생성되어 있는 경우 이 명령이 실패합니다. 사이트는 단일 웹 서비스 구성 설정 컬렉션으로 제한되기 때문입니다.

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

$x = New-CsWebServiceConfiguration -Identity site:Redmond -InMemory
$x.EnableGroupExpansion = $False 
$x.UseCertificateAuth = $True
Set-CsWebServiceConfiguration -Instance $x

예제 2는 예제 1에 표시된 명령의 변형된 형태입니다. 그러나 여기에서는 웹 서비스 구성 설정의 새 컬렉션이 처음에 메모리에만 생성되고 나중에 레드몬드 사이트에 적용됩니다. 이를 수행하기 위해 이 예제의 첫 번째 명령이 New-CsWebServiceConfiguration을 사용하여 레드몬드 사이트에 대한 설정 컬렉션을 만들고, 이 컬렉션이 메모리에만 생성되고 레드몬드 사이트에 즉시 적용되지 않도록 InMemory 매개 변수가 포함됩니다. 설정은 메모리에만 존재하므로 변수에 저장해야 합니다. 이 경우에는 $x라는 변수입니다.

이 예제의 둘째 명령과 셋째 명령은 이러한 가상 구성 설정을 가져오고 EnableGroupExpansion 및 UseCertificateAuth 속성의 값을 수정합니다. 이러한 변경이 완료되면 마지막 명령이 Set-CsWebServiceConfiguration을 사용하여 가상 설정을 가져와 레드몬드 사이트에 적용합니다. Set-CsWebServiceConfiguration을 호출하지 않으면 사이트에 새 설정이 할당되지 않습니다. 대신, Windows PowerShell 세션을 종료하거나 변수 $x를 삭제하는 즉시 가상 웹 서비스 구성 설정이 사라집니다.

참고 항목

기타 리소스

Get-CsWebServiceConfiguration
Remove-CsWebServiceConfiguration
Set-CsWebServiceConfiguration