Get-CsTopology
上一次修改主题： 2012-03-23
返回有关 Microsoft Lync Server 2010 基础结构的信息，包括内部域、站点、群集、计算机、服务和 SQL Server 后端实例。
语法
Get-CsTopology [-AsXml <SwitchParameter>] [-LocalStore <SwitchParameter>]
详细说明
Get-CsTopology cmdlet 返回有关如何设置和配置 Lync Server 2010 的信息。如果不带其他任何参数进行调用，此 cmdlet 将提供 Lync Server 基础结构的概述；在这种情况下，此 cmdlet 将提供域、站点以及运行 Lync Server 服务和服务器角色的计算机等的总体概述。此外，您还可以将 Get-CsTopology 的输出传递到 Select-Object cmdlet，这使您可以访问部分拓扑的详细信息。例如，以下命令提供了有关 Lync Server 使用的 SQL 服务器实例的详细信息：
Get-CsTopology | Select-Object –ExpandProperty SqlInstances
还可以使用 AsXml 参数以 XML 格式返回有关整个拓扑的详细信息。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsTopology cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
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 拓扑。然后将此信息通过管道传递到 Select-Object cmdlet，后者使用 ExpandProperty 属性提取并显示该拓扑中包含的所有计算机的详细信息。
-------------------------- 示例 3 --------------------------
Get-CsTopology -AsXML | Out-File C:\Logs\Topology.xml
示例 3 中显示的命令返回有关 Lync Server 拓扑的信息，然后将这些信息保存为 XML 文件。为完成此任务，该命令首先调用带有 AsXml 参数的 Get-CsTopology，以将要返回的数据设置为 XML 格式。然后将带有格式的数据通过管道传递到 Out-File cmdlet，后者将信息保存到文件 C:\Logs\Topology.xml 中。