Set-CsRegistrar
Letztes Änderungsdatum des Themas: 2012-03-26
Ermöglicht es Ihnen, die Eigenschaften einer oder mehrerer Registrierungen zu ändern. Registrierungen dienen zum Authentifizieren von Anmeldeanforderungen und Verwalten von Informationen zu Status und Verfügbarkeit von Benutzern.
Syntax
Set-CsRegistrar [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-BackupRegistrar <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-EnableAutomaticFailover <$true | $false>] [-FailbackDetectionInterval <TimeSpan>] [-FailureDetectionInterval <TimeSpan>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-Registrar <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-UserServer <String>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Die Registrierung ist wohl die wichtigste Komponente von Microsoft Lync Server 2010. Sie ist Voraussetzung für die Anmeldung der Benutzer beim System, und Lync Server 2010 wäre ohne Registrierung nicht in der Lage, den aktuellen Standort und Status der Benutzer zu verfolgen. Wenn sich ein Benutzer bei Lync Server anmeldet, sendet der Endpunkt, von dem aus sich der Benutzer anmeldet (wie z. B. ein Computer, ein Mobiltelefon oder ein anderes Gerät), eine REGISTER-Anforderung an den Registrierungsserver. Als Antwort darauf fordert der Server die Anmeldeinformationen des Clientgeräts an. Wenn der Client die Anforderung erfüllt (d. h. gültige Anmeldeinformationen bereitstellt), ist der Benutzer authentifiziert, und Endpunktinformationen wie IP-Adresse, Port und Benutzername werden in der Registrierungsdatenbank protokolliert. Meldet sich der Benutzer ab, werden diese Informationen aus der Datenbank entfernt. Zwischen der An- und Abmeldung hält die Registrierung die Statusinformationen aktuell und unterstützt die Weiterleitung von Nachrichten an diesen und von diesem Benutzer.
Mit dem Cmdlet Set-CsRegistrar können Sie die Eigenschaften einer oder mehrerer Registrierungen in Ihrer Organisation ändern. Dazu kann das Ändern der Porteinstellungen gehören sowie das Angeben der Aktion, die ausgeführt werden soll, wenn die Registrierung nicht mehr verfügbar ist.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsRegistrar 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-CsRegistrar\b"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsIdentity |
Dienstidentifizierung der zu ändernden Registrierung. Beispiel: -Identity "Registrar:atl-cs-001.litwareinc.com". Beachten Sie, dass Sie das Präfix "Registrar:" auch weglassen können, wenn Sie eine Registrierung festlegen. Beispiel: -Identity "atl-cs-001.litwareinc.com". |
ArchivingServer |
Optional |
Zeichenfolge |
Dienstidentifizierung des Archivierungsservers, der der Registrierung zugeordnet werden soll. Beispiel: -ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com". |
BackupRegistrar |
Optional |
Zeichenfolge |
Dienstidentifizierung der Registrierung, die verwendet werden soll, wenn diese Registrierung nicht verfügbar ist. Beispiel: -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com". |
EdgeServer |
Optional |
Zeichenfolge |
Dienstidentifizierung des Edgeservers, der der Registrierung zugeordnet werden soll. Beispiel: -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com". |
EnableAutomaticFailover |
Optional |
Boolescher Wert |
Wird dieser Parameter auf "True" festgelegt, wird die Sicherungsregistrierung jedes Mal verwendet, wenn die primäre Registrierung nicht verfügbar ist. Wird er auf "False" festgelegt, wird die Sicherungsregistrierung nicht verwendet, wenn die primäre Registrierung nicht verfügbar ist. Dieser Parameter wirkt sich auch auf Benutzer aus, die bei einer Sicherungsregistrierung registriert sind. Wenn Sie den Parameter auf "True" festlegen, werden diese Benutzer aus der Sicherungsregistrierung gelöscht und in der primären Registrierung neu registriert, sobald diese verfügbar ist. |
FailbackDetectionInterval |
Optional |
TimeSpan |
Gibt an, wie lange das System wartet, bevor überprüft wird, ob eine zuvor nicht verfügbare Registrierung wieder verfügbar ist. Wenn Sie "EnableAutomaticFailover" auf "True" festgelegt haben, findet ein Systemfailover auf die Sicherungsregistrierung statt, sobald eine Registrierung nicht mehr verfügbar ist. Das heißt, das System versucht, Benutzer, die bei der nicht verfügbaren Registrierung angemeldet sind, bei der Sicherungsregistrierung anzumelden. Mit der Eigenschaft "FailbackDetectionInterval" wird festgelegt, wie lange das System wartet, bevor überprüft wird, ob die ursprüngliche Registrierung wieder verfügbar ist. Wenn dies der Fall ist, versucht Lync Server einen Failback auf diese Registrierung durchzuführen. Bei einem Failback findet ein Wechsel zur anfänglich verwendeten Registrierung statt, d. h., Benutzer werden wieder bei der ursprünglichen Registrierung angemeldet. Beachten Sie, dass ein Failback nur automatisch durchgeführt werden kann. Sie können einen Failback von einer Registrierung zu einer anderen nicht manuell durchführen. Das Ermittlungsintervall kann auf einen beliebigen Wert zwischen 30 Sekunden und 84.400 Sekunden (24 Stunden) festgelegt werden. Geben Sie den Zeitraum im Format "Stunden:Minuten:Sekunden" an. Das Intervall wird beispielsweise wie folgt auf 1 Stunde und 15 Minuten festgelegt: - FailbackDetectionInterval 01:15:00. Dieser Parameter kann nicht verwendet werden, es sei denn, Sie haben eine Sicherungsregistrierung angegeben. |
FailureDetectionInterval |
Optional |
TimeSpan |
Gibt an, wie lange das System wartet, bevor es entscheidet, dass eine Registrierung nicht verfügbar ist. Wenn "EnableAutomaticFailover" auf "True" festgelegt wurde, versucht das System, die Benutzer stattdessen bei der Sicherungsregistrierung anzumelden. Das Ermittlungsintervall kann auf einen beliebigen Wert zwischen 30 Sekunden und 84.400 Sekunden (24 Stunden) festgelegt werden. Geben Sie den Zeitraum im Format "Stunden:Minuten:Sekunden" an. Das Intervall wird beispielsweise wie folgt auf 1 Stunde und 15 Minuten festgelegt: - FailureDetectionInterval 01:15:00. Dieser Parameter kann nicht verwendet werden, es sei denn, Sie haben eine Sicherungsregistrierung angegeben. |
MonitoringServer |
Optional |
Zeichenfolge |
Dienstidentifizierung des Monitoring Servers, der der Registrierung zugeordnet werden soll. Beispiel: -MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com". |
Registrar |
Optional |
Zeichenfolge |
Dienstidentifizierung der Registrierung. |
SipPort |
Optional |
Ganze Zahl |
Port für den SIP-Datenverkehr (Session Initiation Protocol). |
SipHealthPort |
Optional |
Zeichenfolge |
Port für die Überwachung der Serverintegrität. |
SipServerTcpPort |
Optional |
Zeichenfolge |
SIP-Überwachungsport. Der Standardwert ist 5060. |
UserServer |
Optional |
Zeichenfolge |
Dienstidentifizierung des Benutzerdiensteservers, der der Registrierung zugeordnet werden soll. Beispiel: -UserServer "UserServer:atl-cs-001.litwareinc.com". |
WebPort |
Optional |
Ganze Zahl |
Port für die Kommunikation mit Webservern. |
WebServer |
Optional |
Zeichenfolge |
Dienstidentifizierung des Webservers, der der Registrierung zugeordnet werden soll. Beispiel: -WebServer "WebServer: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-CsRegistrar akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Set-CsRegistrar gibt keine Objekte oder Werte zurück. Stattdessen werden mit dem Befehl vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.Xds.DisplayRegistrar" geändert.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -SipPort 5072
Der Befehl in Beispiel 1 legt den SIP-Port für die Registrierung "Registrar:atl-cs-001.litwareinc.com" auf 5072 fest.
-------------------------- Beispiel 2 --------------------------
Get-CsService -Registrar | ForEach-Object {Set-CsRegistrar -Identity $_.Identity -SipPort 5072}
Mit dem vorstehenden Befehl wird der SIP-Port für alle Registrierungen in der Organisation auf 5072 festgelegt. Dazu verwendet der Befehl zunächst das Cmdlet Get-CsService und den Parameter "Registrar", um eine Auflistung aller derzeit verwendeten Registrierungen zurückzugeben. Diese Auflistung wird dann an das Cmdlet ForEach-Object weitergeleitet, das für jede Registrierung in der Auflistung das Cmdlet Set-CsRegistrar ausführt, um den SIP-Port in 5072 zu ändern.
-------------------------- Beispiel 3 --------------------------
Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com" -EnableAutomaticFailover $True
In Beispiel 3 werden eine Sicherungsregistrierung (BackupRegistrar) und ein automatisches Failover (EnableAutomaticFailover) für die Registrierung "Registrar:atl-cs-001.litwareinc.com" konfiguriert.