Get-CsTopology
Ultima modifica dell'argomento: 2012-03-23
Restituisce informazioni sull'infrastruttura di Microsoft Lync Server 2010, inclusi domini interni, siti, cluster, computer, servizi e istanze back-end di SQL Server.
Sintassi
Get-CsTopology [-AsXml <SwitchParameter>] [-LocalStore <SwitchParameter>]
Descrizione dettagliata
Il cmdlet Get-CsTopology restituisce informazioni su come è stato installato e configurato Lync Server 2010. Se chiamato senza alcun parametro aggiuntivo, il cmdlet fornisce una panoramica dell'infrastruttura di Lync Server. In questo scenario il cmdlet offre una visione generale di elementi quali domini, siti e computer che eseguono servizi e ruoli del server di Lync Server. In alternativa, è possibile passare l'output di Get-CsTopology al cmdlet Select-Object. In questo modo è possibile accedere a informazioni dettagliate su una parte della topologia. Il seguente comando ad esempio fornisce informazioni dettagliate sulle istanze di SQL Server utilizzate da Lync Server:
Get-CsTopology | Select-Object –ExpandProperty SqlInstances
È anche possibile utilizzare il parametro AsXml per restituire informazioni dettagliate sull'intera topologia in formato XML.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsTopology i membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins.
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
AsXml |
Facoltativo |
Parametro opzionale |
Restituisce informazioni sulla topologia in formato XML. Combinando Get-CsTopology, il parametro AsXml e il cmdlet Out-File, è possibile esportare la topologia in un file XML. |
LocalStore |
Facoltativo |
Parametro opzionale |
Recupera i dati della topologia dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso. |
Tipi di input
Nessuno. Get-CsTopology non accetta l'input da pipeline.
Tipi restituiti
Get-CsTopology restituisce le istanze dell'oggetto Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology.
Esempio
-------------------------- Esempio 1 ------------------------
Get-CsTopology
Il comando precedente restituisce dettagli completi per la topologia Lync Server. Questa operazione viene effettuata chiamando Get-CsTopology senza parametri aggiuntivi.
-------------------------- Esempio 2 ------------------------
Get-CsTopology | Select-Object -ExpandProperty Machines
Nell'esempio 2 vengono restituite informazioni sui computer rilevati nella topologia Lync Server. A tale scopo, questo comando chiama innanzitutto Get-CsTopology per restituire la topologia di Lync Server completa. Queste informazioni vengono quindi inviate tramite pipe al cmdlet Select-Object, che utilizza il parametro ExpandProperty per estrarre e visualizzare informazioni dettagliate per tutti i computer inclusi in tale topologia.
-------------------------- Esempio 3 ------------------------
Get-CsTopology -AsXML | Out-File C:\Logs\Topology.xml
Il comando illustrato nell'esempio 3 restituisce informazioni sulla topologia Lync Server e quindi salva tali informazioni in un file XML. Per eseguire questa attività, il comando chiama innanzitutto Get-CsTopology insieme al parametro AsXml. In questo modo vengono restituiti dati XML formattati. Tali dati formattati vengono quindi inviati tramite pipe al cmdlet Out-File, che salva le informazioni nel file C:\Logs\Topology.xml.