• Artikel

Get-CsConferenceDirectory

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den Konferenzverzeichnissen zurück, die für die Verwendung in Ihrer Organisation konfiguriert sind. Konferenzverzeichnisse helfen den Benutzern von Einwahlkonferenzen beim Suchen nach Konferenzinformationen.

Syntax

Get-CsConferenceDirectory [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsConferenceDirectory [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Wenn Sie einen Einwahlkonferenz-URI (Uniform Resource Identifier) erstellen, wird diesem URI eine eindeutige SIP-Adresse zugewiesen. SIP-Adressen lassen sich aber nicht problemlos auf nicht SIP-fähige Geräten übersetzen. Ein Gerät für das Telefonfestnetz (Public Switched Telephone Network, PSTN) kann eine SIP-Adresse beispielweise nicht interpretieren. Aus diesem Grund verwendet Microsoft Lync Server 2010 Konferenzverzeichnisse, anhand derer diese Geräte Einwahlkonferenzen suchen und eine Verbindung mit diesen herstellen können. Hierzu wird ein SIP-Konferenzverzeichnis erstellt, das jedem Einwahlkonferenz-URI zugeordnet ist und statt durch einen SIP-URI durch einen Ganzzahlenwert identifiziert wird. Festnetztelefone und andere Geräte können diese Nummern (statt eines SIP-URI) dann beim Herstellen von Verbindungen zu Konferenzen verwenden. Die Verzeichnisnummer ist in der PSTN-Konferenz-ID enthalten, die Benutzer beim Herstellen einer Verbindung mit einer Einwahlkonferenz eingeben.

Mit dem Cmdlet Get-CsConferenceDirectory können Sie Informationen zu allen Konferenzverzeichnissen zurückgeben, die für die Verwendung in Ihrer Organisation konfiguriert sind.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsConferenceDirectory lokal auszufü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-CsConferenceDirectory"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Numerische ID (beispielsweise 7) des zurückzugebenden Konferenzverzeichnisses. Wenn dieser Parameter ausgelassen wird, werden mit Get-CsConferenceDirectory alle derzeit in Ihrer Organisation verwendeten Konferenzverzeichnisse zurückgegeben.

Filter

Optional

Zeichenfolge

Ermöglicht es Ihnen, Platzhalter beim Festlegen der Identitätswerte des Konferenzverzeichnisses (oder der Konferenzverzeichnisse) zu verwenden, die zurückgegeben werden sollen. Da Verzeichnisidentitätswerte numerisch sind, hat dieser Parameter u. U. einen sehr kleinen Wert. Diese Syntax gibt jedoch alle Konferenzverzeichnisse zurück, die einen Identitätswert aufweisen, der mit 3 beginnt: -Filter "3*".

LocalStore

Optional

Switch-Parameter

Ruft die Daten zum Konferenzverzeichnis aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsConferenceDirectory akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsConferenceDirectory werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.PstnConf.ConferenceDirectories" zurückgegeben.

Beispiel

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

Get-CsConferenceDirectory

Der Befehl in Beispiel 1 gibt Informationen zu allen Konferenzverzeichnissen zurück, die für die Verwendung in Ihrer Organisation konfiguriert sind.

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

Get-CsConferenceDirectory -Identity 2

In Beispiel 2 werden Informationen zum Konferenzverzeichnis mit dem Identitätswert "2" zurückgegeben. Da Identitätswerte eindeutig sein müssen, wird mit diesem Befehl niemals mehr als ein Konferenzverzeichnis zurückgegeben.

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

Get-CsConferenceDirectory | Where-Object {$_.ServiceID -match "UserServer:atl-cs-001.litwareinc.com"}

Mit dem vorstehenden Befehl werden alle Konferenzverzeichnisse zurückgegeben, die sich im Dienst "UserServer:atl-cs-001.litwareinc.com" befinden. Hierzu ruft der Befehl zunächst Get-CsConferenceDirectory ohne Parameter auf, um eine Auflistung aller in der Organisation verwendeten Konferenzverzeichnisse zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Verzeichnisse herausfiltert, bei denen "ServiceID" den Zeichenfolgenwert "UserServer:atl-cs-001.litwareinc.com" aufweist.