Set-CsAutodiscoverConfiguration

 

마지막으로 수정된 항목: 2017-04-04

기존 자동 검색 서비스 구성 설정 모음을 수정할 수 있습니다. 자동 검색 서비스를 사용하면 Lync Web App 또는 Lync Mobile 등의 클라이언트 응용 프로그램에서 사용자의 홈 풀 또는 전화 접속 회의 참가용 URL 같은 주요 리소스를 찾을 수 있습니다. 이 cmdlet은 Lync Server 2010용 2011년 11월 누적 업데이트에서 도입되었습니다.

Set-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsAutodiscoverConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-EnableCertificateProvisioningServiceUrl <$true | $false>] [-ExternalSipClientAccessFqdn <String>] [-ExternalSipClientAccessPort <UInt32>] [-Force <SwitchParameter>] [-WebLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 Set-CsAutoDiscoverConfiguration cmdlet을 로컬로 실행할 수 있습니다.

 

매개 변수 필수 유형 설명

Confirm

선택

System.Management.Automation.SwitchParameter

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

EnableCertificateProvisioningServiceUrl

선택

System.Boolean

True(기본값)로 설정하면 인증서 프로비전 서비스 URL이 자동 검색 서비스 응답에 포함됩니다.

ExternalSipClientAccessFqdn

선택

System.String

외부 클라이언트 액세스에 사용되는 서버의 FQDN(정규화된 도메인 이름)입니다.

ExternalSipClientAccessPort

선택

System.UInt32

외부 클라이언트 액세스에 사용되는 포트입니다.

Force

선택

System.Management.Automation.SwitchParameter

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

Identity

선택

Microsoft.Rtc.Management.Xds.XdsIdentity

수정할 자동 검색 구성 설정 컬렉션의 고유 식별자입니다. 전역 컬렉션을 수정하려면 다음 구문을 사용합니다.

-Identity "global"

사이트 범위에서 구성된 컬렉션을 수정하려면 다음과 같은 구문을 사용합니다.

-Identity "site:Redmond"

이 매개 변수를 지정하지 않으면 Set-CsAutoDiscoverConfiguration cmdlet이 전역 설정을 자동으로 수정합니다.

Instance

선택

AutoDiscoverConfiguration 개체

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

WebLinks

선택

System.Management.Automation.PSListModifier

자동 검색 URL 컬렉션입니다. 이러한 URL은 New-CsWebLink cmdlet을 사용하여 만들어야 합니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

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

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

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

 
표시: