New-CsSimpleUrlEntry
Letztes Änderungsdatum des Themas: 2012-10-17
Erstellt einen neuen Eintrag für eine einfache URL, der für das Erstellen einer einfachen URL erforderlich ist. Einfache URLs erleichtern Benutzern die Teilnahme an Besprechungen und Konferenzen sowie Administratoren die Anmeldung an der Microsoft Lync Server 2010-Systemsteuerung.
Syntax
New-CsSimpleUrlEntry -Url <String>
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 zweifelsfrei 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. Das Cmdlet New-CsSimpleUrlEntry erstellt einen URL-Eintrag. Dies ist im Grunde eine URL (wie z. B. https://meet.litwareinc.com), die als einfache URL (für Besprechungen, die 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-CsSimpleUrlEntry 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-CsSimpleUrlEntry"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Url |
Erforderlich |
Zeichenfolge |
URL, die der Eigenschaft "SimpleUrlEntry" einer einfachen URL hinzugefügt werden soll. Beispiel: -Url "https://meet.litwareinc.com". URLs müssen mit dem Präfix "https:" beginnen. |
Eingabetypen
Keine.
Rückgabetypen
Mit New-CsSimpleUrlEntry werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.SimpleUtl.SimpleUrlEntry" 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.
-------------------------- Beispiel 2 ------------------------
$urlEntry = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$urlEntry2 = New-CsSimpleUrlEntry -Url "https://dialin.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrl $urlEntry -ActiveUrl "https://meet.fabrikam.com"
$simpleUrl2 = New-CsSimpleUrl -Component "dialin" -Domain "*" -SimpleUrl $urlEntry -ActiveUrl "https://dialin.fabrikam.com"
Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl, $simpleUrl2}
In Beispiel 2 werden zwei URL-Einträge einer vorhandenen Auflistung von einfachen URLs hinzugefügt. Dazu erstellt der erste Befehl im Beispiel mit New-CsSimpleUrlEntry einen URL-Eintrag, der auf "https://meet.fabrikam.com" verweist. Dieser URL-Eintrag wird in der Variablen "$urlEntry" gespeichert. Der zweite Befehl erstellt dann einen zweiten URL-Eintrag, der in der Variablen "$urlEntry2" gespeichert wird und auf die URL "https:// dialin.fabrikam.com" verweist.
Nachdem die zwei URL-Einträge erstellt wurden, werden mit New-CsSimpleUrl zwei nur im Arbeitsspeicher vorhandene Instanzen einer einfachen URL erstellt. In der ersten Instanz wird die URL-Komponente auf "Meet", die Domäne auf "fabrikam.com", und die Eigenschaft "ActiveURL" auf "https://meet.fabrikam.com" festgelegt. In der zweiten Instanz wird die Komponente auf "Dialin", die Domäne auf ein Sternchen (*), und die Eigenschaft "ActiveURL" auf "https://dialin.fabrikam.com" festgelegt.
Nach der Erstellung der URLs (und ihrer Speicherung im Objektverweis "$simpleUrl" und "$simpleUrl2") fügt der letzte Befehl im Beispiel die neuen URLs der Auflistung einfacher URLs für den Standort "Redmond" hinzu. Hierzu werden das Cmdlet Set-CsSimpleUrlConfiguration, der Parameter "SimpleUrl" und der Parameterwert "@{Add=$simpleUrl, $simpleUrl2}" verwendet. Diese Syntax sorgt dafür, dass die im Objektverweis "$simpleUrl" und '"$simpleUrl2" gespeicherten URLs der Eigenschaft "SimpleUrl" hinzugefügt werden.