Get-CsTopology
上次修改主題的時間： 2012-03-23
傳回有關 Microsoft Lync Server 2010 基礎結構的資訊，包括內部網域、站台、叢集、電腦、服務，和 SQL Server 的後端執行個體。
語法
Get-CsTopology [-AsXml <SwitchParameter>] [-LocalStore <SwitchParameter>]
詳細描述
Get-CsTopology 指令程式會傳回如何安裝與設定 Lync Server 2010 的相關資訊。不使用任何其他參數呼叫此指令程式時，會提供您 Lync Server 基礎結構的概觀；這個情況就像是指令程式提供您諸如網域、站台及執行 Lync Server 服務和伺服器角色之電腦的整體概觀。或者，您可將 Get-CsTopology 的輸出傳遞給 Select-Object 指令程式；這麼做讓您可以存取您部分拓撲的詳細資訊。例如，以下命令會提供詳細資訊，是有關 Lync Server 所使用的 SQL Server 執行個體：
Get-CsTopology | Select-Object –ExpandProperty SqlInstances
您也可以使用 AsXml 參數以 XML 格式傳回有關整個拓撲的詳細資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsTopology Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
AsXml |
選用 |
切換參數 |
傳回 XML 格式的拓撲資訊。結合 Get-CsTopology、AsXml 參數及 Out-File 指令程式，可將您的拓撲匯出到 .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 拓撲。接著將此資訊傳送給 Select-Object 指令程式，這會使用 ExpandProperty 參數擷取及顯示該拓撲中所包含之所有電腦的詳細資訊。
-------------------------- 範例 3 ------------------------
Get-CsTopology -AsXML | Out-File C:\Logs\Topology.xml
範例 3 所示的命令會傳回有關您的 Lync Server 拓撲的資訊，然後將資訊儲存為 XML 檔。為了執行此作業，命令會先呼叫 Get-CsTopology 搭配 AsXml 參數；這使得資料以 XML 格式傳回。接著，格式化的資料會傳送給 Out-File 指令程式，這會將資訊儲存到 C:\Logs\Topology.xml 檔案。