• Artikel

Remove-CsConferenceDirectory

 

Letztes Änderungsdatum des Themas: 2012-03-25

Verschiebt ein vorhandenes Konferenzverzeichnis. Konferenzverzeichnisse helfen den Benutzern von Einwahlkonferenzen beim Suchen nach Konferenzinformationen.

Syntax

Remove-CsConferenceDirectory -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<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 mit Konferenzen verwenden. Die Verzeichnisnummer ist in der PSTN-Konferenz-ID enthalten, die Benutzer beim Herstellen einer Verbindung mit einer Einwahlkonferenz eingeben.

Konferenzverzeichnisse werden mit dem Cmdlet New-CsConferenceDirectory erstellt. Sie müssen möglicherweise gelegentlich ein oder mehrere dieser Verzeichnisse löschen, da Sie beispielsweise den Pool außer Betrieb setzen müssen, in dem die Verzeichnisse gehostet werden. Konferenzverzeichnisse können entfernt werden, indem das Cmdlet Remove-CsConferenceDirectory aufgerufen wird. Beachten Sie, dass Sie durch den Aufruf des Cmdlets Move-CsConferenceDirectory ein Verzeichnis aus einem Pool in einen anderen verschieben können.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-CsConferenceDirectory 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 "Remove-CsConferenceDirectory"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Numerischer Identitätswert des Konferenzverzeichnisses, das entfernt werden soll.

Force

Optional

Switch-Parameter

Entfernt das Konferenzverzeichnis, wenn vorhanden, selbst wenn der Pool derzeit nicht verfügbar ist, der das Verzeichnis hostet. Mit Remove-CsConferenceDirectory werden standardmäßig keine Verzeichnisse entfernt, wenn der entsprechende Pool nicht kontaktiert werden kann.

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

Microsoft.Rtc.Management.WritableConfig.Settings.PstnConf.ConferenceDirectories-Objekt. Remove-CsConferenceDirectory akzeptiert eine weitergeleitete Eingabe von Konferenzverzeichnisobjekten.

Rückgabetypen

Keine. Stattdessen werden mit Removes-CsConferenceDirectory Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.PstnConf.ConferenceDirectories" gelöscht.

Beispiel

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

Remove-CsConferenceDirectory -Identity 2

Der Befehl in Beispiel 1 löscht das Konferenzverzeichnis mit dem Identitätswert 2.

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

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

Mit dem vorstehenden Befehl werden alle für den Dienst "UserServer:atl-cs-001.litwareinc.com" gefundenen Konferenzverzeichnisse gelöscht. Dazu ruft der Befehl zunächst Get-CsConferenceDirectory ohne Parameter auf, um eine Auflistung aller Konferenzverzeichnisse zurückzugeben, die derzeit in Ihrer Organisation verwendet werden. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Verzeichnisse herausfiltert, die unter dem Dienst "UserServer:atl-cs-001.litwareinc.com" gehostet werden. Diese gefilterte Auflistung wird an das Cmdlet Remove-CsConferenceDirectory weitergeleitet und gelöscht.