New-CsRegistrarConfiguration

Syntax

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

Detaillierte Beschreibung

Die Registrierung ist wohl die wichtigste Komponente von Lync Server, da sie Grundlage für die Anmeldung der Benutzer am System ist und Lync Server 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 können nur in Verbindung mit dem Registrierungsdienst verwendet werden.)

Mit dem Cmdlet New-CsRegistrarConfiguration können Sie neue Registrierungskonfigurationseinstellungen für die Standort- oder die Dienstebene erstellen. Beachten Sie, dass ein Standort oder ein Dienst höchstens eine solche Auflistung von Einstellungen aufweisen kann. Wenn Sie versuchen, einem Standort oder einem Dienst, der bereits über eine Auflistung von Registrierungskonfigurationseinstellungen verfügt, eine neue Auflistung hinzuzufügen, tritt beim Ausführen des Befehls ein Fehler auf. Der Befehl wird auch dann nicht erfolgreich sein, wenn Sie versuchen, neue Einstellungen auf globaler Ebene zu erstellen.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet New-CsRegistrarConfiguration lokal auszufü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 "New-CsRegistrarConfiguration"}

Parameter

Eingabetypen

Keine. New-CsRegistrarConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit New-CsRegistrarConfiguration werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings" erstellt.

Beispiel

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

New-CsRegistrarConfiguration -Identity site:Redmond -MaxEndpointsPerUser 4 -EnableDHCPServer $True

Mit dem vorstehenden Befehl wird eine neue Auflistung von Registrierungskonfigurationseinstellungen für den Standort "Redmond" (-Identity "site:Redmond") erstellt. Neben dem Identitätswert für die neuen Einstellungen legt der Befehl auch die maximale Anzahl Endpunkte pro Benutzer auf den Wert 4 fest (-MaxEndpointsPerUser 4) und aktiviert die Verwendung des DHCP-Servers für die Clientregistrierung (-EnableDHCPServer $True). Beachten Sie, dass beim Ausführen dieses Befehls ein Fehler auftritt, wenn dem Standort "Redmond" bereits eine Auflistung von Registrierungskonfigurationseinstellungen zugewiesen wurde.

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

$x = New-CsRegistrarConfiguration -Identity site:Redmond -InMemory 
$x.MaxEndpointsPerUser = 4 
$x.EnableDHCPServer = $True
Set-CsRegistrarConfiguration -Instance $x

Die Befehle in Beispiel 2 erstellen ebenfalls eine neue Auflistung von Registrierungskonfigurationseinstellungen für den Standort "Redmond" (-Identity site:Redmond). In diesem Beispiel werden die Einstellungen jedoch zunächst nur im Arbeitsspeicher erstellt und später auf den Standort angewendet.

Hierzu erstellt der erste Befehl mit New-CsRegistrarConfiguration eine neue Auflistung von Einstellungen für "site:Redmond". Der Parameter "-InMemory" wird am Ende des Befehls angehängt, um sicherzustellen, dass diese neuen Einstellungen nur im Arbeitsspeicher erstellt und nicht sofort auf den Standort "Redmond" angewendet werden. Da diese Einstellungen nur im Arbeitsspeicher vorhanden sind, müssen sie in einer Variablen gespeichert werden, in diesem Beispiel "$x".

In den Befehlen 2 und 3 werden zwei Eigenschaften dieser neuen virtuellen Einstellungen ("MaxEndpointsPerUser" und "EnableDHCPServer") geändert. Der letzte Befehl in diesem Beispiel verwendet dann Set-CsRegistrarConfiguration, um die in "$x" gespeicherten virtuellen Einstellungen in tatsächliche Registrierungskonfigurationseinstellungen zu konvertieren, die auf den Standort "Redmond" angewendet werden. Wenn Set-CsRegistrarConfiguration nicht aufgerufen wird, werden keine neuen Einstellungen für den Standort "Redmond" erstellt und die virtuellen Einstellungen gehen verloren, sobald die Windows PowerShell beendet oder die Variable "$x" gelöscht wird.

Siehe auch

Weitere Ressourcen

Get-CsRegistrarConfiguration
Remove-CsRegistrarConfiguration
Set-CsRegistrarConfiguration