• Artikel

Remove-CsDialInConferencingDtmfConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Entfernt eine vorhandene Auflistung von DTMF-Signaleinstellungen (Dual Tone Multifrequency, Mehrfrequenzverfahren), die für Einwahlkonferenzen verwendet werden. Mit DTMF können Benutzer, die sich bei einer Konferenz einwählen, Konferenzeinstellungen mit der Telefontastatur steuern (z. B. eigene Person stummschalten bzw. Stummschaltung der eigenen Person aufheben oder Konferenz sperren bzw. entsperren).

Syntax

Remove-CsDialInConferencingDtmfConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Mit Microsoft Lync Server 2010 können Benutzer Konferenzen beitreten, indem sie sich über das Telefon einwählen. Einwählbenutzer können keine Videos ansehen oder Sofortnachrichten mit anderen Konferenzteilnehmern austauschen. Sie können jedoch am Audioteil der Besprechung vollständig teilnehmen.

Benutzer können nicht nur einer Konferenz beitreten, sondern auch ausgewählte Teile dieser Konferenz mit der Telefontastatur verwalten. (Welche spezifischen Konferenzeinstellungen ein Benutzer verwalten darf, ist davon abhängig, ob ein Benutzer ein Referent ist.) Benutzer können z. B. standardmäßig die Taste 6 auf der Tastatur drücken, um die eigene Person stummzuschalten oder die Stummschaltung der eigenen Person aufzuheben. Benutzer können die Namen aller Teilnehmer der Besprechung privat wiedergeben, wohingegen Referenten alle Besprechungsteilnehmer stummschalten bzw. die Stummschaltung aufheben oder die Ansage aktivieren/deaktivieren können. Diese Ansage wird wiedergegeben, wenn ein Teilnehmer der Konferenz beitritt oder die Konferenz verlässt.

Die Möglichkeit, eine solche Auswahl über die Telefontastatur vornehmen zu können, wird als DTMF-Signalisierung (Dual-Tone Multifrequency, Mehrfrequenzverfahren) bezeichnet: Wenn Sie beispielsweise einmal eine Telefonnummer gewählt haben und angewiesen wurden, die Taste 1 für Englisch oder die Taste 2 für Spanisch zu drücken, haben Sie eine DTMF-Signalisierung verwendet.

Wenn Sie Lync Server 2010 installieren, wird eine globale Auflistung von DTMF-Einstellungen für Sie erstellt. Sie können neben diesen globalen Einstellungen das Cmdlet New-CSDialInConferencingDtmfConfiguration verwenden, um benutzerdefinierte Einstellungen für einzelne Standorte zu erstellen. Einstellungen, die Sie auf Standortebene erstellen, können später mit dem Cmdlet Remove-CSDialInConferencingDtmfConfiguration entfernt werden. Wenn Sie DTMF-Einstellungen entfernen, die auf Standortebene angewendet wurden, gelten für die Benutzer des betroffenen Standorts die globalen DTMF-Konfigurationseinstellungen.

Sie können das Cmdlet Remove-CSDialInConferencingDtmfConfiguration auch für globale Einstellungen ausführen. In diesem Fall werden die globalen Einstellungen jedoch nicht entfernt, da Sie globale DTMF-Einstellungen nicht entfernen können. Stattdessen werden alle Eigenschaften in den globalen Einstellungen auf die Standardwerte zurückgesetzt. Angenommen, Sie haben die globalen Einstellungen geändert und die Taste 4 als Taste für die Stummschaltung bzw. Aufhebung der Stummschaltung definiert. Wenn Sie jetzt das Cmdlet Remove-CSDialInConferencingDtmfConfiguration für die globalen Einstellungen ausführen, wird der Tastenwert für die Stummschaltung/Aufhebung der Stummschaltung wieder auf den Standardwert 6 zurückgesetzt.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Die eindeutige ID der Auflistung von DTMF-Einstellungen, die entfernt werden soll. Verwenden Sie diese Syntax, um die globalen Einstellungen zu "entfernen": -Identity global. (Wie bereits erwähnt, können Sie die globalen Einstellungen nicht wirklich entfernen. Sie können lediglich die Eigenschaften auf ihre Standardwerte zurücksetzen.) Verwenden Sie eine Syntax wie die folgende, um die auf Standortebene konfigurierte Auflistung zu entfernen: -Identity site:Redmond. Sie können beim Angeben eines Identitätswerts keine Platzhalter verwenden.

Force

Optional

Switch-Parameter

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

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.DialInConferencingSettings.DialInConferencingDtmfConfiguration-Objekt. Remove-CsDialInConferencingDtmfConfiguration akzeptiert weitergeleitete Instanzen des DTMF-Konfigurationsobjekts für Einwahlkonferenzen.

Rückgabetypen

Keine. Stattdessen werden mit Remove-CSDialInConferencingDtmfConfiguration Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration" gelöscht.

Beispiel

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

Remove-CSDialInConferencingDtmfConfiguration -Identity site:Redmond

Mit dem vorstehenden Befehl wird die Auflistung von DTMF-Konfigurationseinstellungen mit dem Identitätswert "site:Redmond" gelöscht.

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

Get-CSDialInConferencingDtmfConfiguration -Filter "site:*" | Remove-CSDialInConferencingDtmfConfiguration

Der Befehl in Beispiel 2 löscht alle DTMF-Einstellungen, die auf Standortebene konfiguriert wurden. Hierzu verwendet der Befehl zunächst Get-CSDialInConferencingDtmfConfiguration und den Parameter "Filter", um eine Auflistung aller DTMF-Einstellungen zurückzugeben, die auf Standortebene konfiguriert wurden. Der Filterwert "site:*" stellt sicher, dass nur die Einstellungen zurückgegeben werden, deren Identitätswert mit dem Zeichenfolgenwert "site:" beginnt. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CSDialInConferencingConfiguration weitergeleitet, das jedes Element in der Auflistung entfernt.

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

Get-CSDialInConferencingDtmfConfiguration | Where-Object {$_.PrivateRollCallCommand -eq $Null} | Remove-CSDialInConferencingDtmfConfiguration

In Beispiel 3 wird Remove-CSDialInConferencingDtmfConfiguration verwendet, um alle DTMF-Einstellungen zu löschen, bei denen die Eigenschaft "PrivateRollCallCommand" einem Nullwert entspricht. (Dies bedeutet, dass der Befehl zum Aufruf der Teilnehmerliste deaktiviert wurde.) Hierzu gibt der Befehl zunächst mit Get-CSDialInConferencingDtmfConfiguration eine Auflistung aller derzeit in der Organisation verwendeten DTMF-Einstellungen zurück. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen "PrivateRollCallCommand" einen Nullwert aufweist. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CSDialInConferencingDtmfConfiguration weitergeleitet, das jedes Element in der Auflistung löscht.