Get-CsTopology
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen zur Ihrer Microsoft Lync Server 2010-Infrastruktur zurück, darunter interne Domänen, Standorte, Cluster, Computer, Dienste und Backend-Instanzen von SQL Server.
Syntax
Get-CsTopology [-AsXml <SwitchParameter>] [-LocalStore <SwitchParameter>]
Detaillierte Beschreibung
Mit dem Cmdlet Get-CsTopology werden Informationen zum Setup und zur Konfiguration von Lync Server 2010 zurückgegeben. Das Cmdlet wird ohne zusätzliche Parameter aufgerufen und bietet einen Überblick über Ihre Lync Server-Infrastruktur. Mit dem Cmdlet erhalten Sie in diesem Szenario einen Überblick über Ihre Domänen, Ihre Standorte und die Computer, auf denen Lync Server-Dienste und -Serverrollen ausgeführt werden. Sie können die Ausgabe des Cmdlets Get-CsTopology aber auch an das Cmdlet Select-Object übergeben. So können Sie ausführliche Informationen zu einem Teil Ihrer Topologie erhalten. Mit dem folgenden Befehl erhalten Sie beispielsweise ausführliche Informationen zu den SQL Server-Instanzen, die von Lync Server verwendet werden:
Get-CsTopology | Select-Object –ExpandProperty SqlInstances
Sie können auch den Parameter "AsXml" verwenden, um ausführliche Informationen zu Ihrer gesamten Topologie im XML-Format zurückzugeben.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsTopology lokal auszuführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
AsXml |
Optional |
Switch-Parameter |
Gibt Topologieinformationen im XML-Format zurück. Mit der Kombination aus Get-CsTopology, dem Parameter "AsXml" und dem Cmdlet Out-File können Sie Ihre Topologie in eine XML-Datei exportieren. |
LocalStore |
Optional |
Switch-Parameter |
Ruft die Topologiedaten aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt sie aus dem zentraler Verwaltungsspeicher selbst abzurufen. |
Eingabetypen
Keine. Get-CsTopology akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Get-CsTopology werden Instanzen des Objekts "Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 ------------------------
Get-CsTopology
Mit dem vorstehenden Befehl werden alle Informationen zu Ihrer Lync Server-Topologie zurückgegeben. Dazu wird Get-CsTopology ohne Parameter aufgerufen.
-------------------------- Beispiel 2 ------------------------
Get-CsTopology | Select-Object -ExpandProperty Machines
In Beispiel 2 werden Informationen zu den Computern in Ihrer Lync Server-Topologie zurückgegeben. Hierzu ruft der Befehl zunächst Get-CsTopology auf, um die vollständige Lync Server-Topologie zurückzugeben. Diese Informationen werden dann an das Cmdlet Select-Object weitergeleitet, das den Parameter "ExpandProperty" verwendet, um ausführliche Informationen zu allen Computern in dieser Topologie zu extrahieren und anzuzeigen.
-------------------------- Beispiel 3 ------------------------
Get-CsTopology -AsXML | Out-File C:\Logs\Topology.xml
Der Befehl in Beispiel 3 gibt Informationen zu Ihrer Lync Server-Topologie zurück und speichert diese Informationen in eine XML-Datei. Hierzu ruft der Befehl zunächst Get-CsTopology mit dem Parameter "AsXml" auf. Daraufhin werden die XML-formatierten Daten zurückgegeben. Die formatierten Daten werden dann an das Cmdlet Out-File weitergeleitet, das die Informationen in der Datei "C:\Logs\Topology.xml" speichert.