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에 파이프됩니다.