Freigeben über

  • Artikel

New-CsSimpleUrlConfiguration

 

Letztes Änderungsdatum des Themas: 2012-10-17

Erstellt eine neue Konfigurationsauflistung für einfache URLs. Einfache URLs erleichtern Benutzern die Teilnahme an Besprechungen und Konferenzen sowie Administratoren die Anmeldung an der Microsoft Lync Server 2010-Systemsteuerung.

Syntax

New-CsSimpleUrlConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 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, Reverse-Proxy-Regeln 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 (beispielsweise New-CsSimpleUrl und Set-CsSimpleUrlConfiguration) zum Auffüllen dieser Auflistungen mit einfachen URLs verwenden. 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-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 "New-CsSimpleUrlConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID für die neue Konfigurationsauflistung für einfache URLs. Da neue Auflistungen nur auf Standortebene erstellt werden können, muss der Identitätswert das Präfix "site:", gefolgt von dem Namen des Standorts, enthalten. Diese Syntax erstellt beispielsweise eine neue Auflistung für den Standort "Redmond": -Identity "site:Redmond".

SimpleUrl

Optional

PS-Listenmodifizierer

Einfache URLs, die für diese Auflistung konfiguriert wurden. Diese URLs müssen mit den Cmdlets New-SimpleUrl und New-SimpleUrlEntry erstellt werden.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

Tenant

Optional

GUID

Dieser Parameter wird mit der lokalen Version von Lync Server nicht verwendet.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Keine.

Rückgabetypen

Mit New-CsSimpleUrlConfiguration werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration" erstellt.

Beispiel

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

New-CsSimpleUrlConfiguration -Identity "site:Redmond"

Der Befehl in Beispiel 1 erstellt eine neue Auflistung einfacher URLs für den Standort "Redmond". Da neben dem Parameter "Identity" keine weiteren Parameter in diesem Befehl enthalten sind, enthält die neue Auflistung keine einfachen URLs. Bei der Ausführung dieses Befehls tritt ein Fehler auf, wenn der Standort "Redmond" bereits eine Auflistung von einfachen URLs hostet.

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

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

$urlEntry2 = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$simpleUrl2 = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry2 

New-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl,$simpleUrl2}

Im vorstehenden Beispiel wird dargestellt, wie eine neue Auflistung von einfachen URLs erstellt werden kann, die zwei einfache URLs enthält (einen für die Verwaltung von Besprechungen und einen für Einwahlkonferenzen). Dazu erstellt der erste Befehl im Beispiel mit New-CsSimpleUrlEntry einen URL-Eintrag, der auf "https://dialin.litwareinc.com" verweist. Dieser URL-Eintrag wird in der Variablen "$urlEntry" gespeichert. Der zweite Befehl erstellt anschließend einen weiteren URL-Eintrag, der auf "https://meet.fabrikam.com" verweist.

Im zweiten Befehl wird mit dem Cmdlet New-CsSimpleUrl eine nur im Arbeitsspeicher vorhandene Instanz einer einfachen URL erstellt. In diesem Beispiel ist die URL-Komponente auf "dialin", die Domäne auf "*", "ActiveUrl" auf "https://dialin.fabrikam.com", und die Eigenschaft "SimpleUrl" auf "$urlEntry" festgelegt. (Die Variable "$urlEntry" repräsentiert den URL-Eintrag, der mit dem ersten Befehl erstellt wurde.) Anschließend wird ein ähnlicher Befehl verwendet um eine einfache URL für "meet.fabrikam.com" zu erstellen.

Nach der Erstellung dieser URLs (und ihrer Speicherung im Objektverweis "$simpleUrl" und "$simpleUrl2") erstellt der letzte Befehl im Beispiel eine neue Auflistung von einfachen URLs für den Standort "Redmond" und fügt die zwei neuen, nur im Arbeitsspeicher vorhandenen URLs zu dieser Auflistung hinzu. Die neuen URLs werden der Auflistung mit dem Cmdlet New-CsSimpleUrlConfiguration, dem Parameter "SimpleUrl" und dem Parameterwert "@{Add=$simpleUrl, $simpleUrl2" hinzugefügt. Diese Syntax sorgt dafür, dass die im Objektverweis "$simpleUrl" und '"$simpleUrl2" gespeicherten URLs der Eigenschaft "SimpleUrl" hinzugefügt werden.