Remove-CsRegistrarConfiguration

Syntax

Remove-CsRegistrarConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 können nur in Verbindung mit dem Registrierungsdienst verwendet werden.)

Mit dem Cmdlet Remove-CsRegistrarConfiguration können Sie Registrierungskonfigurationseinstellungen sowohl auf Standort- als auch auf Dienstebene entfernen. Dadurch werden Registrierungen weder gelöscht noch deinstalliert, sondern es werden nur die Konfigurationseinstellungen entfernt, denen diese Registrierungen unterliegen. Wenn diese Einstellungen weder auf Standort- noch auf Dienstebene vorhanden sind, unterliegt eine Registrierung den globalen Einstellungen.

Remove-CsRegistrarConfiguration kann auch für die globalen Registrierungskonfigurationseinstellungen ausgeführt werden. In diesem Fall werden die Einstellungen jedoch nicht entfernt, da die globalen Einstellungen nicht gelöscht werden können. Stattdessen werden alle Eigenschaften in der globalen Auflistung auf die Standardwerte zurückgesetzt. Wenn Sie beispielsweise den Wert der Eigenschaft "MinEndpointExpiration" in 500 geändert haben, wird dieser Wert auf 300 zurückgesetzt.

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

Parameter

Eingabetypen

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

Rückgabetypen

Keine. Mit Remove-CsRegistrarConfiguration werden stattdessen vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings" gelöscht.

Beispiel

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

Remove-CsRegistrarConfiguration -Identity site:Redmond

Mit dem Befehl in Beispiel 1 werden die Registrierungskonfigurationseinstellungen für den Standort "Redmond" gelöscht. Nachdem diese Einstellungen gelöscht wurden, verwenden Registrierungen am Standort "Redmond" automatisch die globalen Registrierungseinstellungen.

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

Get-CsRegistrarConfiguration -Filter "service:*" | Remove-CsRegistrarConfiguration

Mit dem vorstehenden Befehl werden alle auf Dienstebene zugewiesenen Registrierungskonfigurationseinstellungen gelöscht. Hierzu wird Get-CsRegistrarConfiguration zusammen mit dem Parameter "Filter" aufgerufen. Mit dem Filterwert "service:*" werden die zurückgegebenen Daten auf Einstellungen beschränkt, deren Identitätswert mit der Zeichenfolge "service:" beginnt. Die gefilterte Auflistung wird dann an Remove-CsRegistrarConfiguration weitergeleitet, um sämtliche Elemente in der Auflistung zu löschen.

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

Get-CsRegistrarConfiguration | Where-Object {$_.EnableDHCPServer -eq $True} | Remove-CsRegistrarConfiguration

In Beispiel 3 werden sämtliche Registrierungskonfigurationseinstellungen gelöscht, deren Eigenschaft "EnableDHCPServer" auf "True" festgelegt ist. Hierzu ruft der Befehl zunächst Get-CsRegistrarConfiguration ohne Parameter auf. Dadurch wird eine Auflistung aller derzeit in der Organisation verwendeten Registrierungskonfigurationseinstellungen zurückgegeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "EnableDHCPServer" den Wert "True" aufweist. Die gefilterte Auflistung wird dann an das Cmdlet Remove-CsRegistrarConfiguration weitergeleitet, das alle Elemente aus der Auflistung entfernt.

Siehe auch

Weitere Ressourcen

Get-CsRegistrarConfiguration
New-CsRegistrarConfiguration
Set-CsRegistrarConfiguration