Get-CsUserDatabaseState
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen zum Onlinestatus ("True" oder "False") einer oder mehrerer Microsoft Lync Server 2010-Benutzerdatenbanken zurück.
Syntax
Get-CsUserDatabaseState [-Identity <String>]
Get-CsUserDatabaseState [-RegistrarPool <Fqdn>]
Detaillierte Beschreibung
Lync Server 2010 verwendet die Benutzerdatenbank, um Anwesenheits- und Routinginformationen für Benutzer von Lync Server zu verwalten. Das Cmdlet Get-CsUserDatabaseState bietet Ihnen die Möglichkeit, den aktuellen Status ("online" oder "offline") jeder Benutzerdatenbank zu überprüfen, die derzeit innerhalb der Organisation verwendet wird.
Beachten Sie, dass die Firewallausnahmen für SQL Server Express standardmäßig nicht aktiviert sind, wenn Sie die Standard Edition von Lync Server 2010 installieren. Das bedeutet zugleich, dass Sie das Cmdlet Get-CsUserDatabaseState nicht von einer remoten Instanz von Windows PowerShell aus ausführen können. Der Grund hierfür ist, dass der Befehl nicht durch die Firewall geleitet und auf die SQL Server Express-Datenbank zugreifen kann. Sie können das Cmdlet jedoch weiterhin lokal, d. h. auf dem Standard Edition-Server selbst, ausführen. Wenn Sie Get-CsUserDatabaseState remote ausführen möchten, müssen Sie die Firewallausnahmen für SQL Server Express manuell aktivieren.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsUserDatabaseState lokal ausführen: RTCUniversalServerAdmins. 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-CsUserDatabaseState"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
Zeichenfolge |
Eindeutige ID der Benutzerdatenbank, deren Onlinestatus zurückgegeben werden soll. Beispiel: -Identity "UserDatabase:atl-sql-001.litwareinc.com". "Identity" und "RegistrarPool" dürfen weder im selben Befehl noch zusammen mit Platzhaltern verwendet werden. Wenn beide Parameter ausgelassen werden, gibt Get-CsUserDatabaseState Informationen zu allen derzeit verwendeten Benutzerdatenbanken zurück. |
RegistrarPool |
Optional |
Zeichenfolge |
Vollqualifizierter Domänenname des Registrierungspools, der die Benutzerdatenbank hostet, deren Onlinestatus zurückgegeben werden soll. Beispiel: -RegistrarPool "atl-cs-001.litwareinc.com". "Identity" und "RegistrarPool" dürfen weder im selben Befehl noch zusammen mit Platzhaltern verwendet werden. Wenn beide Parameter ausgelassen werden, gibt Get-CsUserDatabaseState Informationen zu allen derzeit verwendeten Benutzerdatenbanken zurück. |
Eingabetypen
Keine. Get-CsUserDatabaseState akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Get-CsUserDatabaseState werden Instanzen des Objekts "Microsoft.Rtc.Management.Xds.UserStoreState" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 ------------------------
Get-CsUserDatabaseState
Der Befehl in Beispiel 1 gibt den Onlinestatus jeder Benutzerdatenbank zurück, die für die Verwendung in Ihrer Organisation konfiguriert ist.
-------------------------- Beispiel 2 ------------------------
Get-CsUserDatabaseState -Identity "UserDatabase:atl-sql-001.litwareinc.com"
Der Befehl in Beispiel 2 gibt den Onlinestatus einer Benutzerdatenbank zurück: der Datenbank mit dem Identitätswert "UserDatabase:atl-sql-001.litwareinc.com".
-------------------------- Beispiel 3 ------------------------
Get-CsUserDatabaseState -RegistrarPool "atl-cs-001.litwareinc.com"
In Beispiel 3 werden Statusinformationen für alle Benutzerdatenbanken im Registrierungspool "atl-cs-001.litwareinc.com" zurückgegeben.
-------------------------- Beispiel 4 ------------------------
Get-CsUserDatabaseState | Where-Object {$_.Online -eq $True}
Im vorstehenden Beispiel werden Informationen für alle Benutzerdatenbanken zurückgegeben, die derzeit online sind. Hierzu ruft der Befehl zunächst Get-CsUserDatabaseState ohne Parameter auf. Dadurch wird eine Auflistung aller in der Organisation verwendeten Benutzerdatenbanken zurückgegeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Datenbanken herausfiltert, bei denen die Eigenschaft "Online" den Wert "True" aufweist.