Set-CsUserDatabaseState
Letztes Änderungsdatum des Themas: 2012-03-27
Aktiviert oder deaktiviert eine oder mehrere Microsoft Lync Server 2010-Benutzerdatenbanken.
Syntax
Set-CsUserDatabaseState -Online <$true | $false> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsUserDatabaseState -Identity <String> -Online <$true | $false> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Lync Server 2010 verwendet die Benutzerdatenbank, um Anwesenheits- und Routinginformationen für Benutzer von Lync Server zu verwalten. Das Cmdlet Set-CsUserDatabaseState bietet die Möglichkeit, den Status einer oder mehrerer Benutzerdatenbanken zu ändern: Sie können das Cmdlet verwenden, um eine Datenbank offline zu schalten bzw. eine deaktivierte Datenbank wieder online zu schalten.
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 Set-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 Set-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 Set-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 "Set-CsUserDatabaseState"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
Zeichenfolge |
Eindeutige ID der Benutzerdatenbank, deren Onlinestatus geändert 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. |
Online |
Erforderlich |
Boolescher Wert |
Mit dem Wert "True" ("$True") wird die Datenbank online zur Verfügung gestellt. Mit dem Wert "False" ($False) wird die Datenbank offline geschaltet. |
RegistrarPool |
Optional |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) des Registrierungspools, der die Benutzerdatenbank hostet, deren Onlinestatus geändert werden soll. Beispiel: -RegistrarPool atl-cs-001.litwareinc.com. "-Identity" und "-RegistrarPool" dürfen weder in demselben Befehl noch in Verbindung mit Platzhaltern verwendet werden. |
Force |
Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können. |
||
WhatIf |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
||
Confirm |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Zeichenfolge. Set-CsUserDatabaseState akzeptiert einen Zeichenfolgenwert, der den Identitätswert der zu aktualisierenden Benutzerdatenbank darstellt.
Rückgabetypen
Keine. Stattdessen werden mit Set-CsUserDatabaseState vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.Xds.UserStoreState" geändert.
Beispiel
-------------------------- Beispiel 1 ------------------------
Set-CsUserDatabaseState -Identity "UserDatabase:atl-sql-001.litwareinc.com" -Online $False
Der Befehl in Beispiel 1 schaltet die Benutzerdatenbank "UserDatabase:atl-sql-001.litwareinc.com" offline. Dazu wird die Eigenschaft "Online" auf "$False" gesetzt.
-------------------------- Beispiel 2 ------------------------
Set-CsUserDatabaseState -RegistrarPool atl-cs-001.litwareinc.com -Online $False
In Beispiel 2 werden alle Benutzerdatenbanken im Registrierungspool "atl-cs-001.litwareinc.com" offline geschaltet.
-------------------------- Beispiel 3 ------------------------
Get-CsUserDatabaseState | Where-Object {$_.Online -eq $False} | ForEach-Object {Set-CsUserDatabaseState -Identity $_.Identity -Online $True}
Im vorstehenden Beispiel werden alle Datenbanken, die derzeit offline sind, gesucht und wieder online geschaltet. Dazu ruft der Befehl zunächst Get-CsUserDatabaseState ohne Parameter auf, um eine Auflistung aller Benutzerdatenbanken in der Organisation zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Datenbanken herausfiltert, bei denen die Eigenschaft "Online" den Wert "False" aufweist. Die gefilterte Auflistung wird dann an das Cmdlet ForEach-Object weitergeleitet, das für jede Datenbank in der Auflistung die Eigenschaft "Online" auf "True" festlegt. Beachten Sie, dass die Auflistung von Datenbanken, die offline sind, an das Cmdlet ForEach-Object anstatt an das Cmdlet Set-CsUserDatabaseState weitergeleitet werden muss. Der Grund dafür ist, dass letzteres Cmdlet weitergeleitete Informationen nicht direkt akzeptieren kann.