Set-CsAutodiscoverConfiguration

구문

Set-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WebLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsAutodiscoverConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WebLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]

자세한 정보

클라이언트 응용 프로그램에서 Microsoft Lync Server 2010을 최대한 효과적으로 사용하도록 하려면 이러한 응용 프로그램에서 주요 Lync Server 2010 구성 요소의 위치를 인식하고 있어야 합니다. 예를 들어 인증된 사용자가 해당 홈 풀을 찾을 수 있어야 합니다. 즉, 이러한 사용자는 해당 홈 풀을 통해서만 인증될 수 있습니다. 마찬가지로, 인증되지 않은 사용자가 전화 회의에 참가하는 데 사용되는 URL을 찾는 등의 작업을 수행할 수 있어야 합니다.

모든 사용자가 조직의 방화벽 외부에서 로그온한 경우에는 이러한 위치를 검색하기가 비교적 쉽습니다. 하지만 사용자가 Microsoft Lync Mobile 또는 Lync Web Access를 사용하여 외부 위치에서 시스템에 액세스하게 되면 이처럼 비교적 단순한 작업도 점점 더 복잡해집니다.

이는 분할 도메인 시나리오에서 특히 심하게 나타나는데, 이러한 시나리오의 경우 조직의 일부 사용자는 온-프레미스 버전의 Lync Server에 계정을 가지고 있지만 다른 사용자는 Microsoft Office 365에 계정을 가지고 있습니다. 이 경우 사용자 계정이 각기 다른 Active Directory 포리스트에 있을 수 있는데, 이렇게 되면 특정한 문제가 발생할 수 있습니다. 예를 들어 미국의 사용자가 유럽에서 로그온하는 경우 시스템에서는 이 사용자의 포리스트를 인식한 다음 로그온 요청을 적절한 풀에 조회할 수 있어야 합니다.

자동 검색 서비스는 바로 이러한 문제를 해결하기 위해 Lync Server의 2011년 11월 릴리스에 도입되었습니다. 클라이언트 응용 프로그램이 Lync Server에 액세스를 시도하면 자동 검색 서비스에서는 클라이언트 SIP 주소를 구문 분석한 다음 해당 요청을 적절한 풀로 리디렉션합니다. 클라이언트 응용 프로그램은 HTTP 요청을 자동 검색 URL로 보내는 방식으로 자동 검색 서비스에 연결되는데, 자동 검색 서비스가 올바르게 작동하려면 관리자가 이러한 URL을 구성해야 합니다. 참고적으로, URL을 구성하는 것 외에도 관리자는 이러한 URL에 해당하는 DNS 레코드를 만들어야 합니다.

자동 검색 URL은 자동 검색 구성 설정에 할당되며, 이를 통해 이러한 설정을 전역 범위나 사이트 범위에 할당할 수 있습니다. Lync Server를 설치하면 설정의 전역 컬렉션이 자동으로 만들어집니다. 그러나 이 컬렉션에 자동 검색 URL이 할당되지는 않습니다. 자동 검색 설정 컬렉션 하나로 요구 사항이 해결되지 않는 경우에는 New-CsAutoDiscoverConfiguration cmdlet을 사용하여 사이트 범위에서 추가 구성 설정을 만들 수 있습니다. 그런 다음 Set-CsAutoDiscoverConfiguration cmdlet을 사용하여 전역 컬렉션 또는 사이트 범위 컬렉션에서 자동 검색 URL을 추가 또는 제거할 수 있습니다.

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

매개 변수

입력 형식

Set-CsAutoDiscoverConfiguration은 Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration 개체의 파이프라인된 입력을 허용합니다.

반환 형식

없음. Set-CsAutoDiscoverConfiguration은 Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration 개체의 인스턴스를 수정합니다.

예제

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

$Link1 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscover.fabrikam.com"

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Add=$Link1}

예제 1에 표시된 명령은 Redmond 사이트에 할당된 자동 검색 구성 설정에 새 자동 검색 URL(http://LyncDiscover.fabrikam.com)을 추가합니다. 이를 위해 예제의 첫 번째 명령에서는 New-CsWebLink cmdlet을 사용하여 새 자동 검색 URL을 만들며, 이 URL은 $Link1이라는 변수에 저장됩니다. 두 번째 명령에서는 Set-CsAutoDiscoverConfiguration을 사용하여 이러한 설정에 이미 할당된 모든 URL에 새 URL을 추가합니다. 이 작업을 수행하기 위해 WebLinks 매개 변수와 매개 변수 값 @{Add=$Link1}을 사용합니다.

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

$Link1 = Get-CsAutoDiscoverConfiguration  -Identity "site:Redmond" | Select-Object -ExpandProperty WebLinks | Where-Object {$_.Token -eq "Fabrikam"}

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Remove=$Link1}

위의 명령은 자동 검색 구성 설정 컬렉션에서 URL을 제거하는 방법을 보여 줍니다. 이를 위해 컬렉션의 첫 번째 명령에서는 삭제할 URL(Token이 "Fabrikam"인 URL)에 대한 개체 참조를 검색합니다. 이 작업을 수행하기 위해 먼저 Get-CsAutoDiscoverConfiguration cmdlet을 호출하여 Redmond 사이트에 대한 자동 검색 설정을 검색합니다. 그런 다음 이 컬렉션은 ExpandProperty 매개 변수를 사용하여 WebLinks 속성을 "확장"하는 Select-Object cmdlet에 파이프됩니다. 속성이 확장되면 Get-CsAutoDiscoverConfiguration이 해당 속성에 저장된 개별 개체에 액세스할 수 있게 됩니다. 그러면 이러한 WebLinks 개체는 Token 속성이 "Fabrikam"인 개체 하나를 선택하는 Where-Object cmdlet에 파이프됩니다. 그리고 이 WebLinks 개체는 $Link1이라는 변수에 저장됩니다.

그런 후에 예제의 두 번째 명령에서는 Set-CsAutoDiscoverConfiguration을 사용하여 $Link1에 저장된 개체를 제거합니다. 이를 위해 명령에서는 WebLinks 매개 변수와 매개 변수 값 @{Remove=$Link1}을 사용합니다.

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

$Link2 = New-CsWebLink -Token "Contoso" -Href "http://LyncDiscover.contoso.com"

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Replace=$Link2}

예제 3에서는 기존 자동 검색 URL 컬렉션을 단일 URL(이 예제의 경우)로 대체하는 방법을 보여 줍니다. 이 작업을 수행하기 위해 예제의 첫 번째 명령에서는 New-CsWebLink cmdlet을 사용하여 http://LyncDiscover.contoso.com에 대한 새 자동 검색 URL을 만들며, 결과로 생성된 URL은 $Link2라는 변수에 저장됩니다. 그런 다음 두 번째 명령에서는 Set-CsAutoDiscoverConfiguration 및 WebLinks 매개 변수를 사용하여 이전에 Redmond 사이트에 할당된 모든 URL을 제거하고 이를 http://LyncDiscover.contoso.com에 대한 URL로 대체합니다. 이를 위해 명령에서는 Add 또는 Remove 메서드 대신 Replace 메서드를 사용합니다.

-------------------------- 예제 4 --------------------------

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks $Null

예제 4에 표시된 명령에서는 Redmond 사이트에 할당된 모든 자동 검색 URL을 제거합니다. 이를 위해 명령에서는 WebLinks 속성을 null 값으로 설정하며, 이를 통해 이전에 해당 속성에 할당되었던 모든 URL이 삭제됩니다.