Get-CsAutodiscoverConfiguration
Letztes Änderungsdatum des Themas: 2012-04-23
Gibt Informationen zu den Konfigurationseinstellungen für die AutoErmittlung zurück, die derzeit in einer Organisation gelten. Der AutoErmittlungsdienst bietet Clientanwendungen wie Lync Web Access und Microsoft Lync Mobile eine Möglichkeit zum Bestimmen wichtiger Ressourcen, z. B. des Home-Pools eines Benutzers oder der URL für die Teilnahme an einer Einwahlkonferenz.
Syntax
Get-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAutodiscoverConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Detaillierte Beschreibung
Damit Clientanwendungen Microsoft Lync Server 2010 optimal nutzen können, muss ihnen bekannt sein, wo sich wichtige Lync Server 2010-Komponenten befinden. Authentifizierte Benutzer müssen beispielsweise ihren Home-Pool bestimmen können, da sie nur mithilfe dieses Home-Pools authentifiziert werden können. Ebenso müssen nicht authentifizierte Benutzer z. B. die URL kennen, die für die Teilnahme an einer Konferenz zu verwenden ist.
Wenn sich alle Benutzer intern hinter der Firewall der Organisation anmelden, ist das Ermitteln dieser Ressourcen eine relativ einfache Aufgabe, die jedoch komplizierter wird, sobald Benutzer an externen Standorten über Microsoft Lync Mobile oder Lync Web Access auf das System zugreifen.
Dies gilt insbesondere in Szenarien mit getrennten Domänen, bei denen einige Benutzer der Organisation Konten für die lokale Version von Lync Server und andere Benutzer Konten für Microsoft Office 365 haben. In solchen Szenarien können sich Benutzerkonten in unterschiedlichen Active Directory-Gesamtstrukturen befinden, was problematisch sein kann. Wenn beispielsweise ein in den USA ansässiger Benutzer sich von Europa aus anmeldet, muss das System in der Lage sein, seine Gesamtstruktur zu erkennen, um die Anmeldeanforderung anschließend an den ordnungsgemäßen Pool zu verweisen.
Der AutoErmittlungsdienst wurde mit der Version von Lync Server vom November 2011 eingeführt, um diese Problematik in den Griff zu bekommen. Wenn eine Clientanwendung versucht, auf Lync Server zuzugreifen, untersucht der AutoErmittlungsdienst die SIP-Adresse des Clients und leitet die jeweilige Anforderung an den entsprechenden Pool weiter. Clientanwendungen verbinden sich mit dem AutoErmittlungsdienst durch Senden einer HTTP-Anforderung an eine AutoErmittlungs-URL. Diese URLs müssen von Administratoren konfiguriert werden, damit der AutoErmittlungsdienst funktionieren kann. (Zusätzlich zur Konfiguration von URLs müssen Administratoren auch DNS-Einträge erstellen, die diesen URLs entsprechen.)
AutoErmittlungs-URLs werden Konfigurationseinstellungen für die AutoErmittlung zugewiesen, die auf globaler oder Standortebene gelten können. Mit dem Cmdlet "Get-CsAutoDiscoverConfiguration" können Sie Informationen zu den AutoErmittlungseinstellungen (und AutoErmittlungs-URLs) zurückgeben, 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-CsAutoDiscoverConfiguration" lokal ausführen: RTCUniversalServerAdmins.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsIdentity |
Eindeutige ID für die abzurufenden Konfigurationseinstellungen für den AutoErmittlungsdienst. Verwenden Sie folgende Syntax, um die globalen Einstellungen abzurufen: -Identity "global" Verwenden Sie eine Syntax wie die folgende, um auf Standortebene konfigurierte Einstellungen abzurufen: -Identity "site:Redmond" Bei Auslassung dieses Parameters werden mit "Get-CsAutoDiscoverConfiguration" alle derzeit in Ihrer Organisation geltenden Konfigurationseinstellungen für die AutoErmittlung zurückgegeben. |
Filter |
Optional |
Zeichenfolge |
Ermöglicht die Verwendung von Platzhalterzeichen beim Angeben des Identitätswerts der zurückzugebenden Konfigurationseinstellungen für die AutoErmittlung. Verwenden Sie beispielsweise folgende Syntax, um alle auf Standortebene konfigurierten Einstellungen zurückzugeben: -Filter "site:*" Beachten Sie, dass Sie die Parameter "Identity" und "Filter" nicht in demselben Befehl verwenden können. |
LocalStore |
Optional |
Switch-Parameter |
Ruft die Konfigurationsdaten für die AutoErmittlung aus dem lokalen Replikat des zentralen Verwaltungsspeichers statt aus dem zentralen Verwaltungsspeicher selbst ab. |
Eingabetypen
"Get-CsAutoDiscoverConfiguration" akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit "Get-CsAutoDiscoverConfiguration" werden Instanzen des Objekts "Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsAutoDiscoverConfiguration
Der Befehl in Beispiel 1 gibt alle derzeit in der Organisation verwendeten Konfigurationseinstellungen für die AutoErmittlung zurück.
-------------------------- Beispiel 2 --------------------------
Get-CsAutoDiscoverConfiguration -Identity "global"
In Beispiel 2 wird nur eine Auflistung von Konfigurationseinstellungen für die AutoErmittlung zurückgegeben: die globale Auflistung.
-------------------------- Beispiel 3 --------------------------
Get-CsAutoDiscoverConfiguration -Filter "site:*"
Mit dem vorstehenden Befehl werden die Konfigurationseinstellungen für die AutoErmittlung zurückgegeben, die auf Standortebene zugewiesen wurden. Hierzu wird der Parameter "Filter" mit dem Filterwert "site:*" angegeben, der sicherstellt, dass nur die Einstellungen zurückgegeben werden, deren Identitätswert mit der Zeichenfolge "site:" beginnt. Laut Definition handelt es sich bei allen Einstellungen, deren Identitätswert mit "site:" beginnt, um Einstellungen, die auf Standortebene konfiguriert wurden.
-------------------------- Beispiel 4 --------------------------
Get-CsAutoDiscoverConfiguration | Where-Object {$_.WebLinks -like "*fabrikam.com"}
Der Befehl in Beispiel 4 gibt alle Konfigurationseinstellungen für die AutoErmittlung zurück, die eine AutoErmittlungs-URL für "fabrikam.com" aufweisen. Hierzu ruft der Befehl zunächst "Get-CsAutoDiscoverConfiguration" auf, um eine Auflistung aller AutoErmittlungseinstellungen zurückzugeben, die derzeit in Ihrer Organisation verwendet werden. Diese Auflistung wird dann an das Cmdlet "Where-Object" weitergeleitet, das nur die Einstellungen herausfiltert, deren Eigenschaft "WebLinks" den Zeichenfolgenwert "fabrikam.com" enthält.