• Artikel

Get-CsRegistrarConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den derzeit in Ihrer Organisation verwendeten Registrierungskonfigurationseinstellungen zurück. Registrierungen dienen zum Authentifizieren von Anmeldeanforderungen und zum Verwalten von Informationen zu Status und Verfügbarkeit von Benutzern.

Syntax

Get-CsRegistrarConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsRegistrarConfiguration [-Filter <String>] [-LocalStore <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.) Das Cmdlet Get-CsRegistrarConfiguration dient zum Zurückgeben von Informationen zu allen Registrierungskonfigurationsauflistungen, 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 Get-CsRegistrarConfiguration lokal ausführen: RTCUniversalUserAdmins, 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 "Get-CsRegistrarConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID der zurückzugebenden Registrierungskonfigurationseinstellungen. Verwenden Sie diese Syntax, um die globalen Einstellungen zurückzugeben: -Identity global. Verwenden Sie eine Syntax wie die folgende, um die auf Standortebene konfigurierten Einstellungen zurückzugeben: -Identity site:Redmond. Verwenden Sie eine Syntax wie die folgende, um Einstellungen auf Dienstebene zurückzugeben: -Identity service:Registrar:atl-cs-001.litwareinc.com.

Bei Auslassung dieses Parameters werden mit Get-CsRegistrarConfiguration alle derzeit in Ihrer Organisation verwendeten Konfigurationseinstellungen für die Registrierung zurückgegeben.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhaltern zum Zurückgeben einer oder mehrerer Auflistungen von Registrierungskonfigurationseinstellungen. Verwenden Sie beispielsweise folgende Syntax, um alle auf der Standortebene konfigurierten Einstellungen zurückzugeben. -Filter "site:*". Verwenden Sie folgende Syntax, um alle auf der Dienstebene konfigurierten Einstellungen zurückzugeben. -Filter "service:*".

LocalStore

Optional

Switch-Parameter

Ruft die Daten zu den Registrierungskonfigurationseinstellungen aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsRegistrarConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsRegistrarConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings" zurückgegeben.

Beispiel

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

Get-CsRegistrarConfiguration

Der Befehl in Beispiel 1 gibt eine Auflistung aller Registrierungskonfigurationseinstellungen zurück, die derzeit in der Organisation verwendet werden.

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

Get-CsRegistrarConfiguration -Identity site:Redmond

In Beispiel 2 wird eine einzelne Auflistung von Registrierungskonfigurationseinstellungen zurückgegeben: die für den Standort Redmond (-Identity site:Redmond) konfigurierten Einstellungen.

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

Get-CsRegistrarConfiguration -Filter "service:*"

In Beispiel 3 werden Informationen für alle Registrierungskonfigurationseinstellungen zurückgegeben, die auf Dienstebene zugewiesen wurden. Hierzu wird der Befehl mit dem Parameter "Filter" aufgerufen. Der Filterwert "service:*" stellt sicher, dass nur Einstellungen mit einem Identitätswert zurückgegeben werden, der mit dem Zeichenfolgenwert "service:" beginnt.

-------------------------- Beispiel 4 --------------------------

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

Der Befehl in Beispiel 4 gibt Informationen zu den Registrierungskonfigurationseinstellungen zurück, die das Verwenden von DHCP-Servern zum Registrieren von Clients ermöglichen. 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 nur die Einstellungen herausfiltert, bei denen die Eigenschaft "EnableDHCPServer" den Wert "True" aufweist.

-------------------------- Beispiel 5 --------------------------

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

Im vorstehenden Befehl werden Informationen zu allen Registrierungskonfigurationseinstellungen zurückgegeben, die mehr als acht Endpunkte pro Benutzer zulassen. Hierzu gibt der Befehl zunächst mit Get-CsRegistrarConfiguration eine Auflistung aller derzeit in der Organisation verwendeten Registrierungskonfigurationseinstellungen zurück. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "MaxEndpointsPerUser" größer als 8 ist.