Get-CsTopology
Tópico modificado em: 2012-03-23
Retorna informações sobre a infraestrutura do Microsoft Lync Server 2010, inclusive domínios internos, sites, clusters, computadores, serviços e instâncias de back-end do SQL server.
Sintaxe
Get-CsTopology [-AsXml <SwitchParameter>] [-LocalStore <SwitchParameter>]
Descrição Detalhada
O cmdlet Get-CsTopology retorna informações sobre como o Lync Server 2010 foi definido e configurado. Chamado sem nenhum parâmetro adicional, o cmdlet oferece uma visão geral da infraestrutura do Lync Server. Nesta situação, o cmdlet fornece uma visão completa de itens como domínios, sites e computadores que estiverem executando serviços e funções de servidor do Lync Server. Como alternativa, é possível passar a saída de Get-CsTopology para o cmdlet Select-Object; isso permite acessar informações detalhadas sobre uma parte da topologia. Por exemplo: o seguinte comando fornece informações detalhadas a respeito de instâncias do SQL Server usadas pelo Lync Server:
Get-CsTopology | Select-Object –ExpandProperty SqlInstances
Também é possível usar o parâmetro AsXml, para retornar informações detalhadas sobre toda a topologia no formato XML.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsTopology localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins.
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
AsXml |
Opcional |
Parâmetro de opção |
Retorna informações da topologia no formato XML. Combinando-se Get-CsTopology, o parâmetro AsXml e o cmdlet Out-File, é possível exportar a topologia para um arquivo XML. |
LocalStore |
Opcional |
Parâmetro de opção |
Recupera os dados da topologia na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si. |
Tipos de Entrada
Nenhuma. Get-CsTopology não aceita a entrada canalizada.
Tipos de Retorno
Get-CsTopology retorna instâncias do objeto Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsTopology
O comando anterior retorna informações completas sobre a topologia do Lync Server. Isso é realizado chamando-se Get-CsTopology sem nenhum parâmetro adicional.
-------------------------- Exemplo 2 ------------------------
Get-CsTopology | Select-Object -ExpandProperty Machines
O Exemplo 2 retorna informações sobre os computadores localizados na topologia do Lync Server. Para realizar isso, o comando primeiramente chama Get-CsTopology, para retornar a topologia completa do Lync Server. Estas informações serão então canalizadas para o cmdlet Select-Object, que usará o parâmetro ExpandProperty para extrair e exibir informações detalhadas sobre todos os computadores incluídos nessa topologia.
-------------------------- Exemplo 3 ------------------------
Get-CsTopology -AsXML | Out-File C:\Logs\Topology.xml
O comando exibido no Exemplo 3 retorna informações sobre a topologia do Lync Server e depois salva estas informações como um arquivo XML. Para realizar esta tarefa, o comando primeiramente chama Get-CsTopology, juntamente com o parâmetro AsXml, retornando os dados como XML formatado. Estes dados formatados serão então canalizados para o cmdlet Out-File, que salvará as informações no arquivo C:\Logs\Topology.xml.