Set-CsSimpleUrlConfiguration

Syntax

Set-CsSimpleUrlConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-SimpleUrl <PSListModifier>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Set-CsSimpleUrlConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-SimpleUrl <PSListModifier>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

In Microsoft Office Communications Server 2007 R2 wiesen Besprechungen URLs wie die folgende auf:

https://imdf.litwareinc.com/Join?uri=sip%3Akenmyer%40litwareinc.com%3Bgruu%3Bopaque%3Dapp%3Aconf%3Afocus%3Aid%3A125f95a0b0184dcea706f1a0191202a8\&key=EcznhLh5K5t

Diese URLs waren jedoch weder besonders leicht zu merken noch einfach an jemand anderen weiterzuleiten. Die in Lync Server 2010 eingeführten einfachen URLs beseitigen diese Probleme, indem Benutzern URLs wie die folgende bereitgestellt werden:

https://meet.litwareinc.com/kenmyer/071200

Einfache URLs stellen eine Verbesserung gegenüber den in der vorherigen Version von Office Communications Server verwendeten URLs dar. Einfache URLs werden allerdings nicht automatisch erstellt, Sie müssen sie vielmehr selbst konfigurieren. Zusätzlich müssen Sie verschiedene Aufgaben ausführen, z. B. DNS-Einträge (Domain Name System) für jede URL erstellen, Reverseproxyregeln für den externen Zugriff konfigurieren und die einfachen URLs zu Ihren Front-End-Server-Zertifikaten hinzufügen.

Lync Server ermöglicht Ihnen das Erstellen drei verschiedener einfacher URLs:

Meet – wird für Besprechungen verwendet. Sie benötigen mindestens eine Besprechungs-URL für jede SIP-Domäne.

Admin – verweist Administratoren auf die Lync Server 2010-Systemsteuerung.

Dialin – wird für die Einwahlkonferenzen-Webseite verwendet.

Einfache URLs sind in Konfigurationsauflistungen für einfache URLs gespeichert. Beim Installieren von Lync Server wird automatisch eine globale Auflistung erstellt. Sie können außerdem benutzerdefinierte Auflistungen auf Standortebene erstellen. Somit haben Sie die Möglichkeit, an jedem Standort unterschiedliche einfache URLs zu verwenden.

Konfigurationsauflistungen für einfache URLs werden mit dem Cmdlet New-CsSimpleUrlConfiguration erstellt. Anschließend können Sie zusätzliche Cmdlets (wie New-CsSimpleUrl und Set-CsSimpleUrlConfiguration) zum Auffüllen dieser Auflistungen mit einfachen URLs verwenden. Nach Erstellung der Auflistungen ermöglicht Set-CsSimpleUrlConfiguration Ihnen auch das Ändern der URLs, die in diesen Auflistungen gespeichert sind.

Das Hinzufügen einer einfachen URL zu einer Auflistung ist relativ unkompliziert. Zunächst verwenden Sie New-CsSimpleUrl und New-CsSimpleUrlEntry zum Erstellen einer nur im Arbeitsspeicher vorhandenen URL. Anschließend fügen Sie die neue URL über den Befehl "Add" der vorhandenen Auflistung hinzu. Alternativ dazu können Sie auch die Methode "Replace" verwenden, um alle vorhandenen URLs durch die neue zu ersetzen.

Das Entfernen einer URL aus einer Auflistung ist etwas schwieriger; hierzu müssen Sie zuerst einen neuen Objektverweis auf die URL erstellen (der die vorhandene URL imitiert) und die URL anschließend mithilfe dieses Objektverweises und der Methode "Remove" löschen.

Nach der Aktualisierung einer Auflistung einfacher URLs müssen Sie das Cmdlet Enable-CsComputer ausführen.

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

Parameter

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration-Objekt. Das Cmdlet Set-CsSimpleUrlConfiguration akzeptiert weitergeleitete Instanzen des Konfigurationsobjekts für einfache URLs.

Rückgabetypen

Keine.

Beispiel

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

Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl $Null

Der Befehl in Beispiel 1 entfernt alle einfachen URLs vom Standort "Redmond", entfernt jedoch nicht die eigentliche Auflistung einfacher URLs. (Die Auflistung ist nach wie vor vorhanden, enthält jedoch keine URLs.) Hierzu verwendet der Befehl den Parameter "SimpleUrl" und legt den Parameterwert auf "$Null" fest. Auf diese Weise werden alle einfachen URLs aus der Auflistung entfernt.

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

$urlEntry = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry -ActiveUrl "https://meet.fabrikam.com"

Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl}

Im vorstehenden Beispiel wird gezeigt, wie einer bestehenden Auflistung einfacher URLs eine neue URL hinzugefügt werden kann. Dazu wird im Beispiel über den ersten Befehl mit dem Cmdlet New-CsSimpleUrlEntry ein URL-Eintrag erstellt, der auf "https://meet.fabrikam.com" verweist. Dieser URL-Eintrag wird in der Variablen "$urlEntry" gespeichert.

Im zweiten Befehl wird mit New-CsSimpleUrl eine nur im Arbeitsspeicher vorhandene Instanz einer einfachen URL erstellt. In diesem Beispiel ist die URL-Komponente auf "Meet", die Domäne auf "fabrikam.com", "ActiveUrl" auf "https://meet.fabrikam.com" und die Eigenschaft "SimpleUrl" auf "$urlEntry" festgelegt ("$urlEntry" ist der im ersten Befehl erstellte URL-Eintrag).

Nach der Erstellung dieser URL (und ihrer Speicherung im Objektverweis "$simpleUrl") fügt der letzte Befehl im Beispiel die neue URL der Auflistung einfacher URLs für den Standort "Redmond" hinzu. Hierzu werden das Cmdlet Set-CsSimpleUrlConfiguration, der Parameter "SimpleUrl" und der Parameterwert "@{Add=$simpleUrl}" verwendet. Diese Syntax sorgt dafür, dass die im Objektverweis "$simpleUrl" gespeicherte URL der Eigenschaft "SimpleUrl" hinzugefügt wird.

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

$urlEntry = New-CsSimpleUrlEntry -Url "https://fabrikam.vdomain.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry -ActiveUrl "https://meet.fabrikam.com"

Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Remove=$simpleUrl}

Die Befehle in Beispiel 3 zeigen, wie Sie eine einzelne URL aus einer Auflistung einfacher URLs löschen können. Da Set-CsSimpleUrlConfiguration mit URL-Objekten arbeiten muss, beginnt das Beispiel mit der Erstellung eines neuen Objekts, das exakt dieselben Eigenschaftswerte enthält wie die zu löschende URL. Dazu erstellt der erste Befehl mit New-CsSimpleUrlEntry einen URL-Eintrag, der auf "https://meet.fabrikam.com" verweist. Dieser URL-Eintrag wird in einer Variablen namens "$urlEntry" gespeichert.

Nachdem der URL-Eintrag erstellt wurde, erstellt der zweite Befehl mit New-CsSimpleUrl eine im Arbeitsspeicher vorhandene Instanz einer einfachen URL. In diesem Beispiel ist die URL-Komponente auf "Meet", die Domäne auf "fabrikam.com", "ActiveUrl" auf "https://meet.fabrikam.com" und die Eigenschaft "SimpleUrl" auf "$urlEntry" festgelegt ("$urlEntry" ist der im ersten Befehl erstellte URL-Eintrag). Auf diese Weise wird eine nur im Arbeitsspeicher vorhandene URL ($simpleUrl) erstellt, die dieselben Eigenschaftswerte aufweist wie die zu löschende URL.

Der letzte Befehl im Beispiel löscht die URL anschließend aus der Auflistung einfacher URLs für den Standort "Redmond". Hierzu werden das Cmdlet Set-CsSimpleUrlConfiguration, der Parameter "SimpleUrl" und der Parameterwert "@{Remove=$simpleUrl}" verwendet. Diese Syntax sorgt lediglich dafür, dass die im Objektverweis "$simpleUrl" gespeicherte URL aus der Eigenschaft "SimpleUrl" gelöscht wird.

Siehe auch

Weitere Ressourcen

Get-CsSimpleUrlConfiguration
New-CsSimpleUrl
New-CsSimpleUrlConfiguration
New-CsSimpleUrlEntry
Remove-CsSimpleUrlConfiguration