Set-CsUserServer
Letztes Änderungsdatum des Themas: 2012-04-23
Ermöglicht Ihnen die Änderung eines vorhandenen Benutzerdienstepools. Unter anderem stellt der Benutzerdienstepool Anwesenheitsinformationen bereit und hilft bei der Verwaltung von Konferenzen.
Syntax
Set-CsUserServer [-Identity <XdsGlobalRelativeIdentity>] [-ConferenceServer <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-McuFactorySipPort <UInt16>] [-UserDatabase <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Benutzerdienste sind eine umfassende Komponente, die eine Reihe wichtiger Microsoft Lync Server 2010-Rollen durchführt: Zum Beispiel stellen Benutzerdienste Anwesenheitsinformationen bereit, helfen bei der Verwaltung von Onlinekonferenzen (über das Konferenzzustandsobjekt und die Zuordnungsinstanz für Konferenzzustandsobjekte), verarbeiten die Benutzerautorisierung und das Routing auf Benutzerebene und dienen als primäre Schnittstelle zur Back-End-Datenbank. Benutzerdienste unterstützen Sie außerdem bei der Bereitstellung von Benutzerkonten.
Daher ist es wichtig, dass Administratoren die Konfiguration ihrer Benutzerdienstepools genau kennen und diese bei Bedarf ändern. Sie können Informationen über Ihre Benutzerdienstepools mit dem folgenden Befehl abrufen:
Get-CsService -UserServer
Ebenso können Sie das Cmdlet Set-CsUserServer verwenden, um Änderungen an diesen Pools vorzunehmen. Mit Set-CsUserServer können Administratoren die einem Pool zugeordnete Benutzerdatenbank und/oder den entsprechenden Konferenzserver ändern. Außerdem können Sie mit diesem Cmdlet den Port ändern, der für Verbindungen mit der Zuordnungsinstanz für Konferenzzustandsobjekte verwendet wird.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsUserServer 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-CsUserServer"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsIdentity |
Die eindeutige ID für den Benutzerdienstepool, der geändert werden soll. Beispiel: -Identity "UserServer:atl-cs-001.litwareinc.com". Beachten Sie, dass Sie das Präfix "UserServer:" auch auslassen können, wenn Sie einen Benutzerserver angeben. Beispiel: -Identity "atl-cs-001.litwareinc.com". |
ConferenceServer |
Optional |
Zeichenfolge |
Dienst-ID für den dem Benutzerdienstepool zugeordneten Konferenzserver. Beispiel: -ConferenceServer "ConferenceServer:atl-cs-001.litwareinc.com". |
McuFactorySipPort |
Optional |
Ganze Zahl |
Für die Verbindung mit der Zuordnungsinstanz für Konferenzzustandsobjekte (McuFactory) verwendeter Port. Die Zuordnungsinstanz für Konferenzzustandsobjekte weist MCUs (Media Control Units) zu, um Konferenzen bestimmte Medientypen, wie z. B. Audio, hinzuzufügen. |
UserDatabase |
Optional |
Zeichenfolge |
Dienst-ID für die dem Benutzerdienstepool zugeordnete Benutzerdatenbank. Beispiel: -UserDatabase "UserDatabase:atl-cs-001.litwareinc.com". |
Force |
Optional |
Switch-Parameter |
Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Keine. Set-CsUserServer akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Set-CsUserServer werden keine Objekte oder Werte zurückgegeben. Stattdessen ändert das Cmdlet vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.Xds.DisplayUserServer".
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsUserServer -Identity "UserServer:atl-cs-001.litwareinc.com" -McuFactorySipPort 445
Der Befehl in Beispiel 1 ändert den "McuFactorySipPort" für einen einzigen Benutzerdienstepool: den Pool mit dem Identitätswert "UserServer:atl-cs-001.litwareinc.com". In diesem Beispiel wird der Port in 445 geändert.
-------------------------- Beispiel 2 --------------------------
Get-CsService -UserServer | ForEach-Object {Set-CsUserServer -Identity $_.Identity -McuFactorySipPort 445}
Der Befehl in Beispiel 2 ist eine Variante des Befehls in Beispiel 1. In diesem Fall wird die Eigenschaft "McuFactorySipPort" jedoch für alle Benutzerdienstepools geändert, die für die Verwendung in dieser Organisation konfiguriert wurden. Hierzu verwendet der Befehl zunächst das Cmdlet Get-CsService und den Parameter "UserServer", um eine Auflistung aller derzeit verwendeten Benutzerdienstepools zurückzugeben. Diese Auflistung wird anschließend an das Cmdlet ForEach-Object weitergeleitet, das die einzelnen Pools in der Auflistung verarbeitet und "McuFactorySipPort" auf 445 festlegt. Die Daten müssen an ForEach-Object weitergeleitet werden, da das Cmdlet Set-CsUserServer selbst keine weitergeleiteten Daten akzeptiert.