Set-CsAutodiscoverConfiguration

Syntax

Set-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WebLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsAutodiscoverConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WebLinks <PSListModifier>] [-WhatIf [<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. Bei der Installation von Lync Server wird eine globale Auflistung mit Einstellungen erstellt. (Dieser Auflistung werden allerdings keine AutoErmittlungs-URLs zugewiesen.) Wenn eine einzelne Auflistung von AutoErmittlungseinstellungen nicht Ihre Anforderungen erfüllt, können Sie mit dem Cmdlet "New-CsAutoDiscoverConfiguration" weitere Konfigurationseinstellungen auf Standortebene definieren. Anschließend können Sie mit dem Cmdlet "Set-CsAutoDiscoverConfiguration" Auflistungen auf globaler oder Standortebene AutoErmittlungs-URLs hinzufügen oder aus diesen entfernen.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet "Set-CsAutoDiscoverConfiguration" lokal ausführen: RTCUniversalServerAdmins.

Parameter

Eingabetypen

"Set-CsAutoDiscoverConfiguration" akzeptiert weitergeleitete Eingaben des Objekts "Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration".

Rückgabetypen

Keine. Mit "Set-CsAutoDiscoverConfiguration" werden Instanzen des Objekts "Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration" geändert.

Beispiel

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

$Link1 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscover.fabrikam.com"

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Add=$Link1}

Mit den Befehlen in Beispiel 1 wird den dem Standort "Redmond" zugewiesenen Konfigurationseinstellungen für die AutoErmittlung eine neue AutoErmittlungs-URL (http://LyncDiscover.fabrikam.com) hinzugefügt. Hierzu wird im ersten Befehl des Beispiels mit dem Cmdlet "New-CsWebLink" eine neue AutoErmittlungs-URL erstellt, die in der Variablen "$Link1" gespeichert wird. Im zweiten Befehl wird "Set-CsAutoDiscoverConfiguration" zum Hinzufügen der neuen URL zu URLs ausgeführt, die diesen Einstellungen bereits zugewiesen sind. Dies erfolgt über den Parameter "WebLinks" mit dem Parameterwert "@{Add=$Link1}".

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

$Link1 = Get-CsAutoDiscoverConfiguration  -Identity "site:Redmond" | Select-Object -ExpandProperty WebLinks | Where-Object {$_.Token -eq "Fabrikam"}

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Remove=$Link1}

Mithilfe dieser Befehle wird veranschaulicht, wie Sie eine URL aus einer Auflistung von Konfigurationseinstellungen für die AutoErmittlung entfernen können. Hierzu ruft der erste Befehl in der Auflistung einen Objektverweis auf die löschende URL ab (deren Token "Fabrikam" lautet). Dies erfolgt durch Aufrufen des Cmdlets "Get-CsAutoDiscoverConfiguration", um die AutoErmittlungseinstellungen für den Standort "Redmond" abzurufen. Diese Auflistung wird dann an das Cmdlet "Select-Object " weitergeleitet, das mithilfe des Parameters "ExpandProperty" die Eigenschaft "WebLinks" erweitert. (Wird eine Eigenschaft erweitert, hat das Cmdlet "Get-CsAutoDiscoverConfiguration" Zugriff auf die einzelnen in dieser Eigenschaft gespeicherten Objekte.) Diese Objekte vom Typ "WebLinks" werden anschließend an das Cmdlet "Where-Object" weitergeleitet, das das eine Objekt auswählt, dessen Eigenschaft "Token" den Wert "Fabrikam" hat. Dieses Objekt vom Typ "WebLinks" wird dann in der Variablen "$Link1" gespeichert.

Danach wird im zweiten Befehl des Beispiels mit dem Cmdlet "Set-CsAutoDiscoverConfiguration" das in "$Link1" gespeicherte Objekt entfernt. Hierzu verwendet der Befehl den Parameter "WebLinks" und den Parameterwert "@{Remove=$Link1}".

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

$Link2 = New-CsWebLink -Token "Contoso" -Href "http://LyncDiscover.contoso.com"

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Replace=$Link2}

In Beispiel 3 wird gezeigt, wie Sie eine vorhandene Auflistung von AutoErmittlungs-URLs durch eine einzelne URL ersetzen. Hierzu wird im ersten Befehl des Beispiels mit dem Cmdlet "New-CsWebLink" eine neue AutoErmittlungs-URL für "http://LyncDiscover.contoso.com" erstellt, die in der Variablen "$Link2" gespeichert wird. Im zweiten Befehl werden mit dem Cmdlet "Set-CsAutoDiscoverConfiguration" und dem Parameter "WebLinks" alle URLs entfernt, die zuvor dem Standort "Redmond" zugewiesen waren, und durch die URL für "http://LyncDiscover.contoso.com" ersetzt. Hierzu wird im Befehl die Methode "Replace" anstelle der Methode "Add" oder "Remove" verwendet.

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

Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks $Null

Der Befehl in Beispiel 4 entfernt alle AutoErmittlungs-URLs, die dem Standort "Redmond" zugewiesen wurden. Hierzu legt der Befehl die Eigenschaft "WebLinks" auf den Wert "Null" fest, wodurch alle URLs gelöscht werden, die dieser Eigenschaft zuvor zugewiesen waren.