New-CsWebLink

 

Letztes Änderungsdatum des Themas: 2012-04-23

Erstellt einen neuen Weblink, der auf den AutoErmittlungsdienst verweist. 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

New-CsWebLink -Href <String> -Token <String>

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.

Die Verwaltung der Konfigurationseinstellungen für den AutoErmittlungsdienst umfasst meist das Hinzufügen von AutoErmittlungs-URLs. Diese URLs müssen mit dem Cmdlet "New-CsWebLink" erstellt werden, wobei die resultierende URL in einer Variablen gespeichert und anschließend einer Auflistung von Konfigurationseinstellungen für die AutoErmittlung hinzugefügt wird. AutoErmittlungs-URLs basieren auf den in der Organisation verwendeten SIP-Domänen. Administratoren erstellen in der Regel eine URL für Benutzer außerhalb der Firewall der Organisation (z. B. http://LyncDiscover.litwareinc.com) und eine zweite URL (z. B. http://LyncDiscoverInternal.litwareinc.com) für Benutzer hinter der Firewall.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Href

Erforderlich

Zeichenfolge

URL für den AutoErmittlungsdienst. Beispiel:

–Href "http://LyncDiscover.fabrikam.com"

Token

Erforderlich

Zeichenfolge

Der URL zuzuordnender eindeutiger Name. Beispiel:

-Token "Fabrikam"

Eingabetypen

Keine. "New-CsWebLink" akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Erstellt neue Instanzen des Objekts "Microsoft.Rtc.Management.WriteableConfig.Settings.WebLink.WebLink".

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. Danach wird "Set-CsAutoDiscoverConfiguration" zum Hinzufügen der neuen URL zu URLs verwendet, die diesen Einstellungen bereits zugewiesen sind. Dies erfolgt über den Parameter "WebLinks" mit dem Parameterwert "@{Add=$Link1}".

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

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

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

Mit diesen Befehlen wird den dem Standort "Redmond" zugewiesenen Konfigurationseinstellungen für die AutoErmittlung ein Paar neue AutoErmittlungs-URLs ("http://LyncDiscover.fabrikam.com" und "http://LyncDiscoverInternal.fabrikam.com2) hinzugefügt. Hierzu werden in den ersten beiden Befehlen mit dem Cmdlet "New-CsWebLink" die beiden AutoErmittlungs-URLs erstellt, die anschließend in den Variablen "$Link1" und "$Link2" gespeichert werden. Nachdem die beiden URLs erstellt wurden, werden im dritten Befehl mit dem Cmdlet "Set-CsAutoDiscoverConfiguration" die beiden URLs dem Standort "Redmond" zugewiesen. Hierzu wird der Parameter "WebLinks" zusammen mit dem Parameterwert "@{Add=$Link1,$Link2}" angegeben. Diese Syntax sorgt dafür, dass die in den Variablen "$Link1" und "$Link2" gespeicherten Werte der Eigenschaft "WebLinks" der Einstellungen hinzugefügt werden.