New-CsSimpleUrl
Letztes Änderungsdatum des Themas: 2012-10-17
Erstellt eine neue einfache URL, die einer Konfigurationsauflistung einfacher URLs hinzugefügt werden kann. Einfache URLs erleichtern Benutzern die Teilnahme an Besprechungen und Konferenzen sowie Administratoren die Anmeldung an der Microsoft Lync Server 2010-Systemsteuerung.
Syntax
New-CsSimpleUrl -Component <String> -Domain <String> [-ActiveUrl <String>] [-SimpleUrlEntry <PSListModifier>]
Detaillierte Beschreibung
In Microsoft Office Communications Server 2007 R2 wiesen Besprechungen URLs wie die folgende auf:
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 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.
Wenn Sie einer Auflistung einfacher URLs eine tatsächliche URL hinzuzufügen möchten, müssen Sie die URL zunächst mit den Cmdlets New-CsSimpleUrl und New-CsSimpleUrlEntry erstellen. Mit dem Cmdlet New-CsSimpleUrlEntry wird ein URL-Eintrag erstellt: eine URL (wie z. B. "https://meet.litwareinc.com"), die als einfache URL (für Besprechungen, Verwaltung oder Einwahlkonferenzen) verwendet werden kann. Das von New-CsSimpleUrlEntry erstellte Objekt wird der Eigenschaft "SimpleUrlEntry" einer neuen einfachen URL hinzugefügt. Sie müssen das Objekt mit einem separaten Cmdlet erstellen, da die Eigenschaft "SimpleUrlEntry" mehrere URLs umfassen kann. (Allerdings kann nur eine solche URL als aktive URL festgelegt werden. Die aktive URL repräsentiert die tatsächliche für Besprechungen, die Verwaltung und Einwahlkonferenzen verwendete URL.)
Nach dem Erstellen eines Eintrags für eine einfache URL müssen Sie mit dem Cmdlet New-CsSimpleUrl eine Instanz einer einfachen URL erstellen, die nur im Arbeitsspeicher vorhanden ist, und dabei die Komponente (den Typ der einfachen URL), die Domäne, die aktive URL und alle Einträge für einfache URLs definieren. Nachdem Sie ein Objekt erstellt haben, das die einfache URL repräsentiert, können Sie dieses Objekt einer neuen (oder vorhandenen) Auflistung einfacher URLs hinzufügen. 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 New-CsSimpleUrl 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 "New-CsSimpleUrl\b"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Component |
Erforderlich |
Zeichenfolge |
Gibt den Typ der zu erstellenden einfachen URL an. Gültige Werte sind: Meet – Die zum Verwalten von Besprechungen verwendete URL. Admin – URL, die auf die Lync Server 2010-Systemsteuerung verweist. Dialin – Die für Einwahlkonferenzen verwendete URL, Beispiel: -Component "Meet". |
Domain |
Erforderlich |
Zeichenfolge |
SIP-Domäne für die einfache URL. Beispiel: -Domain "litwareinc.com". |
SimpleUrlEntry |
Optional |
PS-Listenmodifizierer |
Auflistung von URLs für die angegebene Komponente. Sie können beispielsweise sowohl "https://meet.litwareinc.com" als auch "https://litwareinc.com/meet" als URL-Einträge für die Komponente "Meet" konfigurieren. Allerdings kann (und muss) nur eine dieser URLs als aktive URL konfiguriert werden. Einfache URL-Einträge müssen mit dem Cmdlet New-CsSimpleUrlEntry erstellt werden. |
ActiveUrl |
Optional |
Zeichenfolge |
Gibt die URL an, auf die Benutzer tatsächlich zugreifen sollen. Die Eigenschaft "SimpleUrlEntry" kann mehrere URLs enthalten, zu einem bestimmten Zeitpunkt kann jedoch nur eine dieser URLs aktiv sein. Wenn Sie versuchen, für "ActiveUrl" einen Wert festzulegen, der nicht in der Eigenschaft "SimpleUrlEntry" enthalten ist, tritt ein Fehler auf. Verwenden Sie zum Zuweisen einer aktiven URL einfach die URL selbst als Parameterwert. Beispiel: -ActiveUrl https://meet.litwareinc.com". |
Eingabetypen
Keine. New-CsSimpleUrl akzeptiert keine weitergeleiteten Daten.
Rückgabetypen
Mit New-CsSimpleUrl werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.SimpleUtl.SimpleUrl" erstellt.
Beispiel
-------------------------- Beispiel 1 --------------------------
$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 "SimpleUrlEntry" 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.