Get-CsPool
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen zu den Pools zurück, die in Ihrer Bereitstellung von Microsoft Lync Server 2010 verwendet werden. Bei einem Pool handelt es sich um eine Auflistung von Computern, die sich alle an demselben Standort befinden und auf denen dieselben Lync Server 2010-Dienste ausgeführt werden.
Syntax
Get-CsPool [-Identity <XdsGlobalRelativeIdentity>] [-Site <String>]
Get-CsPool [-Filter <String>] [-Site <String>]
Detaillierte Beschreibung
In Lync Server 2010 besteht ein Pool aus einem oder mehreren Computer am gleichen Standort, auf denen dieselben Dienste ausgeführt werden. Wenn Sie beispielsweise einen Server am Standort "Redmond" haben, auf dem der Vermittlungsserver ausgeführt wird, hätten Sie einen Vermittlungsserver-Pool, der aus diesem einen Computer besteht. Wenn Sie zwei Computer am Standort "Redmond" haben, auf denen der Vermittlungsserver ausgeführt wird, hätten Sie einen Vermittlungsserver-Pool, der aus zwei Computern besteht. Die Anzahl der Pools in Ihrer Organisation hängt von der Anzahl Ihrer Server und den verschiedenen darauf ausgeführten Diensten ab.
Mit dem Cmdlet Get-CsPool können Informationen zu allen Pools in Ihrer Organisation abgerufen werden, einschließlich Informationen zu den Diensten, die in jedem dieser Pools ausgeführt werden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsPool 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-CsPool"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) des Pools, der zurückgegeben werden soll. Beispiel: -Identity atl-cs-001.litwareinc.com. Wenn dieser Parameter nicht angegeben ist, werden alle Pools in Ihrer Organisation zurückgegeben. |
Filter |
Optional |
Zeichenfolge |
Ermöglicht es Ihnen, beim Angeben der Identität des/der zurückzugebenden Pools Platzhalter zu verwenden. Beispielsweise werden mit folgender Syntax alle Pools zurückgegeben, deren Identität mit dem Zeichenfolgenwert ".fabrikam.com" endet: -Filter "*.fabrikam.com". Beachten Sie, dass Sie die Parameter "Identity" und "Filter" nicht im gleichen Befehl verwenden können. |
Site |
Optional |
Zeichenfolge |
Gibt alle Pools am angegebenen Standort zurück. Der betreffende Standort sollte mit "DisplayName" des Standorts (z. B. "Redmond") statt mit dem Standortidentitätswert (z. B. "site:Redmond") referenziert werden. Beispiel: -Site "Redmond". Durch Ausführen dieses Befehls können Sie die Anzeigenamen für Ihre Standorte abrufen: Get-CsSite | Select-Object Identity, DisplayName |
Eingabetypen
Keine. Get-CsPool akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Get-CsPool werden Instanzen des Objekts "Microsoft.Rtc.Management.Deploy.Internal.Cluster " zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsPool
Mit dem vorstehenden Befehl werden alle Pools in Ihrer Bereitstellung von Lync Server zurückgegeben.
-------------------------- Beispiel 2 --------------------------
Get-CsPool | Select-Object -ExpandProperty Computers
In Beispiel 2 werden ausführliche Informationen zu den Computern in den einzelnen Pools zurückgegeben. Hierzu wird Get-CsPool aufgerufen. Die zurückgegebenen Daten werden dann an das Cmdlet Select-Object weitergeleitet. Der Parameter "ExpandProperty" von "Select-Object" wird verwendet, um den Wert der Eigenschaft "Computers" zu erweitern. Die Eigenschaft "Computers" ist ein Array von Objekten, die die einzelnen Computer im Pool darstellen. Wenn Sie die Eigenschaft "Computers" erweitern, erhalten Sie ausführliche Informationen zu den einzelnen Computern.
-------------------------- Beispiel 3 --------------------------
Get-CsPool -Identity atl-cs-001.litwareinc.com
Im vorherigen Beispiel dient der Parameter "Identity" zum Einschränken der zurückgegebenen Daten auf den einen Pool mit dem Identitätswert "atl-cs-001.litwareinc.com".
-------------------------- Beispiel 4 --------------------------
Get-CsPool -Site "Redmond"
In Beispiel 4 werden alle Pools am Standort Redmond zurückgegeben. Dazu verwendet der Befehl den Parameter "Site". Der Parameterwert "Redmond" beschränkt die zurückgegebenen Daten auf Pools, bei denen die Eigenschaft "Site" den Wert "Redmond" aufweist.
-------------------------- Beispiel 5 --------------------------
Get-CsPool | Where-Object {$_.Services.Count -eq 0}
Der Befehl in Beispiel 5 gibt eine Auflistung aller Pools zurück, in denen keine Lync Server-Dienste installiert sind. Hierzu ruft der Befehl zunächst Get-CsPool ohne Parameter auf. Dadurch wird eine Auflistung aller derzeit in der Organisation verwendeten Pools zurückgegeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Pools herausfiltert, bei denen die Eigenschaft "Services.Count" den Wert 0 aufweist, d. h., es sind keine Lync Server-Dienste für diesen Pool konfiguriert.