다음을 통해 공유


Get-CsTopology

 

마지막으로 수정된 항목: 2012-03-23

내부 도메인, 사이트, 클러스터, 컴퓨터, 서비스 및 SQL Server의 백 엔드 인스턴스 등 Microsoft Lync Server 2010 인프라에 대한 정보를 반환합니다.

구문

Get-CsTopology [-AsXml <SwitchParameter>] [-LocalStore <SwitchParameter>]

자세한 정보

Get-CsTopology cmdlet은 Lync Server 2010이 설정 및 구성된 방식에 대한 정보를 반환합니다. 이 cmdlet을 추가 매개 변수 없이 호출하면 Lync Server 인프라에 대한 개요가 제공됩니다. 여기에서는 이 cmdlet을 통해 도메인, 사이트, Lync Server 서비스 및 서버 역할을 실행하는 컴퓨터 등을 개괄적으로 확인할 수 있습니다. 또는 Select-Object cmdlet에 Get-CsTopology 출력을 전달할 수 있습니다. 이렇게 하면 토폴로지의 한 부분에 대한 자세한 정보에 액세스할 수 있습니다. 예를 들어 다음 명령은 Lync Server에서 사용하는 SQL Server 인스턴스와 관련된 자세한 정보를 제공합니다.

Get-CsTopology | Select-Object -ExpandProperty SqlInstances

또한 AsXml 매개 변수를 사용하여 XML 형식의 전체 토폴로지에 대한 자세한 정보를 반환할 수 있습니다.

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

매개 변수

매개 변수 필수 유형 설명

AsXml

선택

스위치 매개 변수

XML 형식의 토폴로지 정보를 반환합니다. Get-CsTopology, AsXml 매개 변수 및 Out-File cmdlet을 결합하여 토폴로지를 .XML 파일로 내보낼 수 있습니다.

LocalStore

선택

스위치 매개 변수

중앙 관리 저장소 자체가 아니라 중앙 관리 저장소의 로컬 복제본에서 토폴로지 데이터를 검색합니다.

입력 형식

없음. Get-CsTopology는 파이프라인된 입력을 허용하지 않습니다.

반환 형식

Get-CsTopology는 Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology 개체의 인스턴스를 반환합니다.

예제

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

Get-CsTopology

위 명령은 Lync Server 토폴로지에 대한 자세한 세부 정보를 반환합니다. 이 작업을 수행하기 위해 추가 매개 변수 없이 Get-CsTopology를 호출합니다.

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

Get-CsTopology | Select-Object -ExpandProperty Machines

예제 2에서는 Lync Server 토폴로지에 있는 컴퓨터에 대한 정보를 반환합니다. 이 작업을 수행하기 위해 먼저 Get-CsTopology를 호출하여 전체 Lync Server 토폴로지를 반환합니다. 이 정보는 ExpandProperty 매개 변수를 사용하여 해당 토폴로지에 포함된 모든 컴퓨터에 대한 자세한 정보를 추출하고 표시하는 Select-Object cmdlet에 파이프됩니다.

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

Get-CsTopology -AsXML | Out-File C:\Logs\Topology.xml

예제 3에 표시된 명령은 Lync Server 토폴로지에 대한 정보를 반환한 다음 해당 정보를 XML 파일에 저장합니다. 이 작업을 수행하기 위해 먼저 데이터를 서식이 설정된 XML로 반환하는 AsXml 매개 변수와 함께 Get-CsTopology를 호출합니다. 서식이 설정된 이 데이터는 C:\Logs\Topology.xml 파일에 정보를 저장하는 Out-File cmdlet에 파이프됩니다.

참고 항목

기타 리소스

Enable-CsTopology
Publish-CsTopology
Test-CsTopology