• Artikel

Set-CsRegistrarConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert die Eigenschaftswerte in einer vorhandenen Auflistung von Konfigurationseinstellungen für die Registrierung. Registrierungen dienen zum Authentifizieren von Anmeldeanforderungen und zum Verwalten von Informationen zu Status und Verfügbarkeit von Benutzern.

Syntax

Set-CsRegistrarConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]]

Set-CsRegistrarConfiguration [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Die Registrierung ist wohl die wichtigste Komponente von Microsoft Lync Server 2010, da sie Grundlage für die Anmeldung der Benutzer am System ist und Lync Server 2010 ohne Registrierung nicht in der Lage wäre, den aktuellen Standort und Status der Benutzer zu verfolgen. Wenn sich ein Benutzer bei Lync Server anmeldet, sendet der Endpunkt, von dem sich der Benutzer anmeldet, eine REGISTER-Anforderung an den Registrierungsserver. Als Antwort darauf fordert der Server Authentifizierungsinformationen vom Clientgerät 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.

Konfigurationseinstellungen für die Registrierung werden zum Verwalten von Endpunkten und Endpunktabonnements verwendet. Diese Einstellungen können global, auf Standort- oder auf Dienstebene angewendet werden. (Einstellungen auf Dienstebene werden nur in Verbindung mit dem Registrierungsdienst verwendet.) Das Cmdlet Set-CsRegistrarConfiguration kann dazu verwendet werden einige (oder alle) Konfigurationsauflistungen für die Registrierung zu ändern, die derzeit in Ihrer Organisation verwendet werden.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsRegistrarConfiguration 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-CsRegistrarConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID für die zu ändernden Registrierungskonfigurationseinstellungen. Verwenden Sie folgende Syntax, um die globalen Einstellungen zu ändern: -Identity global. Verwenden Sie eine Syntax wie die folgende, um die auf Standortebene konfigurierten Einstellungen zu ändern: -Identity site:Redmond. Verwenden Sie eine Syntax wie die folgende, um Einstellungen auf Dienstebene zu ändern: -Identity service:Registrar:atl-cs-001.litwareinc.com. Beachten Sie, dass Registrierungseinstellungen nur auf den Registrierungsdienst angewendet werden können. Es wird eine Fehlermeldung angezeigt, wenn Sie versuchen, diese Einstellungen auf einen anderen Dienst anzuwenden.

Instance

Optional

RegistrarSettings-Objekt

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen.

DefaultEndpointExpiration

Optional

Ganze Zahl

Endpunkte können bei der Anmeldung ein Ablauftimeout anfordern. Hiermit wird das Zeitintervall angegeben, das ein Endpunkt am System angemeldet sein kann, bevor er den Server kontaktieren und eine Verlängerung anfordern muss. Die Eigenschaft "DefaultEndpointExpiration" stellt das Ablauftimeoutintervall für Clients dar, die keinen bestimmten Timeoutwert anfordern.

Der Wert für "DefaultEndpointExpiration" muss zwischen 300 (5 Minuten) und 900 (15 Minuten) liegen. Der Standardwert lautet 600 (10 Minuten).

EnableDHCPServer

Optional

Boolescher Wert

Gibt an, ob Endpunkte DHCP-Server für die Suche nach einer Registrierung verwenden können. Wenn der Wert "True" lautet, senden Clients zunächst eine DHCP-Benachrichtigung. Der DHCP-Server antwortet darauf mit dem vollqualifizierten Domänennamen (FQDN) einer Registrierung, die für die Anmeldung des Benutzers verwendet werden kann.

MaxEndpointExpiration

Optional

Ganze Zahl

Endpunkte können bei der Anmeldung ein Ablauftimeout anfordern. Hiermit wird das Zeitintervall angegeben, das ein Endpunkt am System angemeldet sein kann, bevor er den Server kontaktieren und eine Verlängerung anfordern muss. Die Eigenschaft "MaxEndpointExpiration" stellt die Höchstdauer dar, die Clients gewährt werden kann. Wenn die Höchstdauer z. B. auf 600 Sekunden festgelegt ist und ein Client ein Timeoutintervall von 800 Sekunden anfordert, wird dem Client der maximal zulässige Ablaufzeitraum gewährt: 600 Sekunden.

Der Wert für "MaxEndpointExpiration" muss zwischen 300 (5 Minuten) und 900 (15 Minuten) liegen. Der Standardwert lautet 900.

MaxEndpointsPerUser

Optional

Ganze Zahl

Gibt die maximale Anzahl von Endpunkten an, mit denen ein Benutzer gleichzeitig mit dem System verbunden sein kann. Ein Benutzer, der sowohl mit einem Computer als auch mit einem Mobiltelefon bei Lync Server 2010 angemeldet ist, verwendet beispielsweise zwei Endpunkte. "MaxEndPointsPerUser" muss auf einen Wert zwischen 1 und 64 (einschließlich) festgelegt werden. Der Standardwert lautet 8.

MinEndpointExpiration

Optional

Ganze Zahl

Endpunkte können bei der Anmeldung ein Ablauftimeout anfordern. Hiermit wird das Zeitintervall angegeben, das ein Endpunkt am System angemeldet sein kann, bevor er den Server kontaktieren und eine Verlängerung anfordern muss. Die Eigenschaft "MinEndpointExpiration" stellt die Mindestdauer dar, die Clients gewährt werden kann. Wenn die Mindestdauer z. B. auf 600 Sekunden festgelegt ist und ein Client ein Timeoutintervall von 200 Sekunden anfordert, wird dem Client der kürzeste zulässige Ablaufzeitraum gewährt: 600 Sekunden.

Der Wert für "MinEndpointExpiration" muss zwischen 300 (5 Minuten) und 900 (15 Minuten) liegen. Der Standardwert lautet 300.

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

Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings-Objekt. Set-CsRegistrarConfiguration akzeptiert weitergeleitete Objektinstanzen der Registrierungseinstellungen.

Rückgabetypen

Set-CsRegistrarConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings" konfiguriert.

Beispiel

-------------------------- Beispiel 1 --------------------------

Set-CsRegistrarConfiguration -Identity site:Redmond -EnableDHCPServer $True

Mit dem vorstehenden Befehl werden die Konfigurationseinstellungen für die Registrierung geändert, die auf den Standort "Redmond" (-Identity site:Redmond) angewendet wurden. Mit dem Befehl in diesem Beispiel wird der Wert der Eigenschaft "EnableDHCPServer" auf "True" festgelegt.

-------------------------- Beispiel 2 --------------------------

Get-CsRegistrarConfiguration | Where-Object {$_.MaxEndpointsPerUser -gt 8} | Set-CsRegistrarConfiguration -MaxEndpointsPerUser 8

In Beispiel 2 werden alle Konfigurationseinstellungen für die Registrierung geändert, die für Benutzer mehr als 8 Endpunkte zulassen. Hierzu ruft der Befehl zunächst Get-CsRegistrarConfiguration ohne Parameter auf. Damit wird eine Auflistung aller Registrierungskonfigurationseinstellungen aufgerufen, die in der Organisation verwendet werden. Diese Auflistung wird anschließend an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "MaxEndpointsPerUser" einen Wert von mehr als 8 aufweist (der Vergleichsoperator "-gt" steht für "greater than"). Abschließend wird die gefilterte Auflistung an das Cmdlet Set-CsRegistrarCollection weitergeleitet, das die maximale Anzahl von Endpunkten pro Element in dieser Auflistung auf 8 festlegt.

-------------------------- Beispiel 3 --------------------------

Get-CsRegistrarConfiguration -Filter "site:*"| Set-CsRegistrarConfiguration -EnableDHCPServer $False

Der Befehl in Beispiel 3 deaktiviert die Clientregistrierung, indem für jeden Standort in der Organisation, der eine Auflistung von Konfigurationseinstellungen für die Registrierung hostet, DHCP verwendet wird. Hierzu ruft der Befehl Get-CsRegistrarConfiguration mit dem Parameter "Filter" auf. Der Parameterwert "site:*" beschränkt die zurückgegebenen Daten auf Einstellungen, die auf Dienstebene konfiguriert wurden. Diese Auflistung wird anschließend an das Cmdlet Set-CsRegistrarConfiguration weitergeleitet, das den Parameter "EnableDHCPServer" und den Parameterwert "$False" verwendet, um eine Clientregistrierung unter Verwendung eines DHCP-Servers zu verhindern.