Get-CsTopology
Última modificación del tema: 2012-03-23
Devuelve la información sobre la infraestructura de Microsoft Lync Server 2010, incluidos los dominios internos, los sitios, clústeres, equipos, servicios e instancias de back-end de SQL Server.
Sintaxis
Get-CsTopology [-AsXml <SwitchParameter>] [-LocalStore <SwitchParameter>]
Descripción detallada
Un cmdlet Get-CsTopology devuelve información sobre la instalación y configuración de Lync Server 2010. Cuando se llama al cmdlet sin parámetros adicionales, el cmdlet proporciona información general sobre la infraestructura de Lync Server. En este escenario, el cmdlet ofrece una visión rápida de aspectos como los dominios, sitios y los equipos que ejecutan servicios y roles de servidor de Lync Server. También se puede pasar el resultado de Get-CsTopology al cmdlet Select-Object. Esto permite acceso a la información detallada sobre una parte de la topología del usuario. Por ejemplo, el siguiente comando proporciona información detallada sobre las instancias de SQL Server usadas por Lync Server:
Get-CsTopology | Select-Object –ExpandProperty SqlInstances
También puede usar el parámetro AsXml para devolver información detallada sobre la topología completa en formato XML.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsTopology de forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins.
Parámetros
Parámetro | Requerido | Tipo | Descripción |
---|---|---|---|
AsXml |
Opcional |
Parámetro modificador |
Devuelve la información de la topología en formato XML. La combinación de Get-CsTopology, con el parámetro AsXml y el cmdlet Out-File permite exportar la topología a un archivo .XML. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera los datos de topología de la réplica local de Almacén de administración central en lugar de recuperarlos de Almacén de administración central. |
Tipos de entrada
Ninguno. Get-CsTopology no acepta la entrada transferida.
Tipos de valores devueltos
Get-CsTopology devuelve instancias del objeto Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsTopology
El comando anterior devuelve la información detallada completa de la topología de Lync Server. Esto se realiza llamando a Get-CsTopology sin ningún parámetro adicional.
-------------------------- Ejemplo 2 ------------------------
Get-CsTopology | Select-Object -ExpandProperty Machines
En el Ejemplo 2 se devuelve información sobre los equipos que se encuentran en la topología de Lync Server del usuario. Para hacerlo, el comando llama primero a Get-CsTopology para devolver la topología completa de Lync Server. Esta información se transfiere a continuación al cmdlet Select-Object, que usa el parámetro ExpandProperty para extraer y mostrar la información detallada de todos los equipos incluidos en la topología.
-------------------------- Ejemplo 3 ------------------------
Get-CsTopology -AsXML | Out-File C:\Logs\Topology.xml
El comando del Ejemplo 3 devuelve la información sobre la topología de Lync Server y a continuación guarda esta información en un archivo XML. Para llevar a cabo esta tarea, el comando llama primero a Get-CsTopology y al parámetro AsXml. Esto hace que los datos se devuelvan con formato XML. Estos datos con formato XML se transfieren a continuación al cmdlet Out-File, que guarda la información en el archivo C:\Logs\Topology.xml.