Get-CsSite
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen zu den für die Microsoft Lync Server 2010-Infrastruktur erstellten Standorten zurück. Standorte stellen eine Sammlung von Lync Server 2010-Pools dar und beziehen sich in der Regel auf geografische Bereiche. Lync Server umfasst zwei Arten von Standorten: Datencenter- und Remotestandorte (Zweigstellen).
Syntax
Get-CsSite [-Identity <XdsGlobalRelativeIdentity>]
Get-CsSite [-Filter <String>]
Detaillierte Beschreibung
Lync Server 2010 führt in der Lync Server-Topologie ein neues Konzept ein: das der Standorte. Standorte (nicht zu verwechseln mit Active Directory-Standorten oder Microsoft Exchange Server-Standorten) sind Sammlungen von Lync Server-Pools und -Servern, die im Allgemeinen basierend auf geografischen Regionen und unter Berücksichtigung der Netzwerkbandbreite organisiert werden. Wenn alle Ihre Computer in Redmond sich beispielsweise im gleichen LAN mit Hochgeschwindigkeitsverbindungen mit geringer Latenz befinden, könnten Sie einen Standort "Redmond" einrichten, der diese Computer umfasst. Wenn die Computer in Dublin sich ebenfalls alle in einem eigenen LAN befinden und die gleichen Hochgeschwindigkeitsverbindungen mit geringer Latenz nutzen, könnten Sie einen separaten Standort "Dublin" einrichten. Standorte sind wichtig für die Verwaltung von Lync Server: Die meisten Richtlinien und Einstellungen können auf Standortebene konfiguriert werden, sodass es ohne Weiteres möglich ist, den Benutzern in Redmond einen Satz mit Wähleinstellungen und den Benutzern in Dublin andere Wähleinstellungen zuzuweisen.
Mit dem Cmdlet Get-CsSite können Informationen zu allen Standorten in Ihrer Organisation zurückgegeben werden, darunter auch Informationen zu den Pools, aus denen diese Standorte bestehen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsSite lokal auszuführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsSite"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
SiteId |
Name des Standorts, der zurückgegeben werden soll. Beachten Sie, dass Sie nur den Standortnamen angeben sollten. Beispiel: -Identity "Redmond". Verwenden Sie zum Festlegen des Identitätswerts nicht das Format "site:Redmond". |
Filter |
Optional |
Zeichenfolge |
Ermöglicht es Ihnen, Platzhalter bei der Festlegung des Identitätswerts eines Standorts bzw. von mehreren Standorten zu verwenden, der bzw. die zurückgegeben werden soll(en). Mit der folgenden Syntax werden beispielsweise alle Pools zurückgegeben, deren Identitätswert die Zeichenfolge "Dublin" enthält: -Filter "*Dublin*". Beachten Sie, dass Sie "Filter" und "Identity" nicht im gleichen Befehl verwenden können. |
Eingabetypen
Keine. Get-CsSite akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Get-CsSite werden Instanzen des Objekts "Microsoft.Rtc.Management.Deploy.Internal.Site+CentralSite" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsSite
In Beispiel 1 werden Informationen für alle Lync Server-Standorte abgerufen.
-------------------------- Beispiel 2 --------------------------
Get-CsSite -Identity "Redmond"
In Beispiel 2 werden Informationen für einen einzelnen Standort zurückgegeben, nämlich für den Standort mit dem Identitätswert "Redmond".
-------------------------- Beispiel 3 --------------------------
Get-CsSite | Where-Object {$_.SiteType -eq "CentralSite"}
Der Befehl in Beispiel 3 gibt Informationen zu Ihrem zentralen Standort zurück. Hierzu ruft der Befehl zunächst Get-CsSite auf, um eine Auflistung aller Standorte zurückzugeben, die für die Verwendung in Ihrer Organisation konfiguriert sind. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das den Standort herausfiltert, bei dem die Eigenschaft "SiteType" den Wert "CentralSite" aufweist.
-------------------------- Beispiel 4 --------------------------
Get-CsSite -Identity "Redmond" | Select-Object -ExpandProperty Pools
Mit dem vorstehenden Befehl wird eine Liste der Pools am Standort "Redmond" angezeigt. Hierzu ruft der Befehl zunächst die vollständigen Informationen für den Standort "Redmond" ab und leitet diese Daten an das Cmdlet Select-Object weiter. Das Cmdlet Select-Object verwendet anschließend den Parameter "ExpandProperty", um den Wert der Eigenschaft "Pools" zu erweitern. Beim Erweitern eines Eigenschaftswerts werden alle in dieser Eigenschaft gespeicherten Werte in benutzerfreundlicher Form auf dem Bildschirm angezeigt.