Get-CsSimpleUrlConfiguration
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen zu den einfachen URLs zurück, die in einer Organisation konfiguriert sind. Einfache URLs erleichtern Benutzern die Teilnahme an Besprechungen und Konferenzen sowie Administratoren die Anmeldung an der Microsoft Lync Server 2010-Systemsteuerung.
Syntax
Get-CsSimpleUrlConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Get-CsSimpleUrlConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
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 DNS-Einträge (Domain Name System) für jede URL erstellen, Reverse-Proxy-Regeln für den externen Zugriff konfigurieren, die einfachen URLs zu Ihren Front-End-Server-Zertifikaten hinzufügen etc.)
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.
Mit dem Cmdlet Get-CsSimpleUrlConfiguration können Sie Informationen zu allen Konfigurationsauflistungen für einfache URLs abrufen, die derzeit in Ihrer Organisation verwendet werden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsSimpleUrlConfiguration lokal ausführen: RTCUniversalUserAdmins, 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 "Get-CsSimpleUrlConfiguration"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Optional |
XdsIdentity |
Eindeutige ID der zurückzugebenden Auflistung einfacher URLs. Verwenden Sie diese Syntax, um die globale Auflistung zurückzugeben: -Identity global. Verwenden Sie eine Syntax wie die folgende, um eine Auflistung auf Standortebene zurückzugeben: -Identity "site:Redmond". Beachten Sie, dass beim Angeben eines Identitätswerts keine Platzhalterzeichen verwendet werden können. Wenn Sie Platzhalter verwenden möchten, verwenden Sie stattdessen den Parameter "Filter". Ein Aufruf von Get-CsSimpleUrlConfiguration ohne Parameter gibt alle einfachen URLs zurück, die in Ihrer Organisation konfiguriert sind. |
Filter |
Optional |
Zeichenfolge |
Ermöglicht die Verwendung von Platzhalterzeichen beim Festlegen der Auflistungen einfacher URLs, die zurückgegeben werden sollen. Verwenden Sie beispielsweise folgende Syntax, um alle auf Standortebene konfigurierten Auflistungen einfacher URLs zurückzugeben: -Filter "site:*". Beachten Sie, dass Sie die Parameter "Identity" und "Filter" nicht im gleichen Befehl verwenden können. |
Tenant |
Optional |
GUID |
Dieser Parameter wird mit der lokalen Version von Lync Server 2010 nicht verwendet. |
LocalStore |
Optional |
Switch-Parameter |
Ruft die Konfigurationsdaten für einfache URLs aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen. |
Eingabetypen
Keine.
Rückgabetypen
Mit Get-CsSimpleUrlConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 ------------------------
Get-CsSimpleUrlConfiguration
Der vorstehende Befehl gibt Informationen zu allen derzeit in Ihrer Organisation verwendeten Konfigurationsauflistungen für einfache URLs zurück. Dazu wird Get-CsSimpleUrlConfiguration ohne Parameter aufgerufen.
-------------------------- Beispiel 2 ------------------------
Get-CsSimpleUrlConfiguration -Identity "site:Redmond"
In Beispiel 2 wird nur eine einzelne Konfiguration für einfache URLs zurückgegeben: die Konfiguration mit dem Identitätswert "site:Redmond".
-------------------------- Beispiel 3 ------------------------
Get-CsSimpleUrlConfiguration -Filter "site:*"
Beispiel 3 gibt Informationen zu allen Konfigurationsauflistungen für einfache URLs zurück, die auf Standortebene zugewiesen wurden. Hierzu wird das Cmdlet Get-CsSimpleUrlConfiguration mit dem Parameter "Filter" aufgerufen. Der Filterwert "site:*" beschränkt die zurückgegebenen Daten auf die Auflistungen, deren Identitätswert mit dem Zeichenfolgenwert "site:" beginnt.
-------------------------- Beispiel 4 ------------------------
Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl
In Beispiel 4 werden ausführliche Informationen für alle einfachen URLs angezeigt, die in der Organisation konfiguriert sind. Hierzu ruft der Befehl zunächst Get-CsSimpleUrlConfiguration auf, um vollständige Informationen zu einfachen URLs zurückzugeben. Diese Daten werden dann an das Cmdlet Select-Object weitergeleitet, das den Parameter "ExpandProperty" zum "Erweitern" des Werts der Eigenschaft "SimpleUrl" verwendet. Beim Erweitern eines Eigenschaftswerts werden alle in dieser Eigenschaft gespeicherten Daten in einem einfach lesbaren Format angezeigt.
-------------------------- Beispiel 5 ------------------------
Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl | Where-Object {$_.Component -eq "Meet"}
Der Befehl in Beispiel 5 gibt alle einfachen URLs für die Verwaltung von Besprechungen zurück, die derzeit in der Organisation verwendet werden. Hierzu ruft der Befehl zunächst Get-CsSimpleUrlConfiguration ohne zusätzliche Parameter auf, um vollständige Informationen zu einfachen URLs zurückzugeben. Diese Daten werden dann an das Cmdlet Select-Object weitergeleitet, das den Parameter "ExpandProperty" zum Erweitern des Werts der Eigenschaft "SimpleUrl" verwendet. Die gefilterte Auflistung wird anschließend an das Cmdlet Where-Object weitergeleitet, das nur die einfachen URLs herausfiltert, bei denen die Eigenschaft "Component" den Wert "Meet" aufweist.
Siehe auch
Weitere Ressourcen
New-CsSimpleUrlConfiguration
Remove-CsSimpleUrlConfiguration
Set-CsSimpleUrlConfiguration