• Artikel

Set-CsDialInConferencingDtmfConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-27

Ändert die Einstellungen für die DTMF-Signalisierung (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

Set-CsDialInConferencingDtmfConfiguration [-Identity <XdsIdentity>] [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-LockUnlockConferenceCommand <String>] [-MuteUnmuteCommand <String>] [-PrivateRollCallCommand <String>] [-WhatIf [<SwitchParameter>]]

Set-CsDialInConferencingDtmfConfiguration [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-Instance <PSObject>] [-LockUnlockConferenceCommand <String>] [-MuteUnmuteCommand <String>] [-PrivateRollCallCommand <String>] [-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 lassen, wohingegen Referenten alle Besprechungsteilnehmer stummschalten bzw. die Stummschaltung aufheben oder die Ansage aktivieren oder 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 (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.

Mit dem Cmdlet Set-CsDialInConferencingDtmfConfiguration können Sie die Tasten ändern, mit denen die in einer Lync Server 2010-Einwahlkonferenz unterstützten Befehle ausgelöst werden.

Beim Ändern der DTMF-Befehle sind zwei Dinge zu beachten: Zum einen können Sie nur die numerischen Tasten 0 bis 9 verwenden. Andere Tasten auf Ihrer Tastatur (z. B. die Taste #) sind nicht zulässig. Es gibt jedoch eine Ausnahme: Für den Parameter "CommandCharacter" können nur die Sternchentaste (*) oder die Rautetaste (#) verwendet werden. Sie können dem Parameter "CommandCharacter" keinen numerischen Wert zuweisen. Alle anderen Befehlsparameter akzeptieren jedoch nur numerische Werte.

Zum anderen müssen Befehle eindeutigen Tasten zugewiesen werden. Die Taste 4 kann beispielsweise für das Stummschalten der eigenen Person und das Aufheben der Stummschaltung der eigenen Person sowie zum Sperren und Entsperren einer Konferenz verwendet werden. Das heißt, wenn die einem Befehl zugewiesenen Tasten geändert werden, müssen Sie möglicherweise die Tasten tauschen, die für zwei verschiedene Befehle verwendet werden. Wenn Sie z. B. für "EnableDisableAnnouncementsCommand" (Standardwert: 9) die Taste 4 zuweisen möchten, müssen Sie "MuteUnmuteAllCommand" die Taste 9 zuweisen.

Legen Sie zum Deaktivieren eines Befehls seinen Wert auf Null ($Null) fest.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

Gibt die eindeutige ID für die Auflistung der zu ändernden DTMF-Einstellungen an. Verwenden Sie folgende Syntax, um auf die globalen Einstellungen zu verweisen: -Identity global. Verwenden Sie eine Syntax wie die folgende, um auf eine Auflistung zu verweisen, die auf Standortebene konfiguriert ist: -Identity site:Redmond. Beachten Sie, dass beim Angeben eines Identitätswerts keine Platzhalterzeichen verwendet werden können.

Wenn dieser Parameter nicht angegeben wird, ändert Set-CsDialInConferencingDtmfConfiguration die globalen DTMF-Einstellungen.

Instance

Optional

DialInConferencingDtmfConfiguration-Objekt

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen.

AdmitAll

Optional

Zeichenfolge

Gibt die Taste an, die gedrückt wird, um zuzulassen, dass alle Benutzer im Wartebereich der Konferenz sofort beitreten. Der Standardwert lautet 8.

AudienceMuteCommand

Optional

Zeichenfolge

Gibt die Taste an, die ein Referent drücken kann, um andere Personen in der Konferenz stummzuschalten (d. h. alle Personen außer dem Referenten werden stummgeschaltet). Die Standardtaste lautet 4.

CommandCharacter

Optional

Zeichenfolge

Gibt die Taste an, die zu Beginn eines Befehls gedrückt wird. Die Standardtaste ist das Sternchen (*). Der einzige andere zulässige Wert ist die Raute (#).

EnableDisableAnnouncementsCommand

Optional

Zeichenfolge

Gibt die Taste an, die zum Aktivieren oder Deaktivieren von Ansagen gedrückt wird, wenn eine Person der Konferenz beitritt oder sie verlässt. Die Standardtaste lautet 9.

HelpCommand

Optional

Zeichenfolge

Gibt die Taste an, die zur privaten Wiedergabe einer Beschreibung aller DTMF-Befehle gedrückt wird. Die Standardtaste lautet 1.

LockUnlockConferenceCommand

Optional

Zeichenfolge

Gibt die Taste an, die zum Sperren oder Entsperren einer Konferenz gedrückt wird. Wenn eine Konferenz gesperrt wird, können erst wieder neue Teilnehmer dieser Konferenz beitreten, wenn die Konferenz entsperrt wird. Die Standardtaste lautet 7.

MuteUnmuteCommand

Optional

Zeichenfolge

Gibt die Taste an, die zum Stummschalten der eigenen Person oder zum Aufheben der Stummschaltung der eigenen Person gedrückt wird. Zum Umschalten zwischen Stummschaltung und Aufhebung der Stummschaltung wird dieselbe Taste verwendet. Die Standardtaste lautet 6.

PrivateRollCallCommand

Optional

Zeichenfolge

Gibt die Taste an, die zur privaten Wiedergabe der Namen aller Konferenzteilnehmer gedrückt wird. Die Standardtaste lautet 3.

Force

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

Rückgabetypen

Set-CsDialInConferencingDtmfConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration" konfiguriert.

Beispiel

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

Set-CsDialInConferencingDtmfConfiguration -Identity global -EnableDisableAnnouncementsCommand 4 -AudienceMuteCommand 9

Der Befehl in Beispiel 1 tauscht die Tasten, die dem Befehl zum Aktivieren und Deaktivieren von Ansagen (Standardwert: 9) und dem Befehl zum Stummschalten aller Teilnehmer bzw. Aufheben der Stummschaltung (Standardwert: 4) für die globalen DTMF-Einstellungen zugewiesen sind. Dazu werden die folgenden beiden Parameter verwendet: "EnableDisableAnnoucementsCommand" erhält den Parameterwert 4 und "MuteUnmuteAllCommand" erhält den Wert 9. Da kein Identitätswert angegeben ist, wirken sich diese Änderungen auf die globalen DTMF-Einstellungen aus.

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

Set-CsDialInConferencingDtmfConfiguration -Identity site:Redmond -EnableDisableAnnouncementsCommand 4 -AudienceMuteCommand 9

Der Befehl in Beispiel 2 ist eine Variante des Befehls in Beispiel 1. In diesem Fall wirken sich die Änderungen jedoch auf die DTMF-Einstellungen mit der Identität "site:Redmond" aus.

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

Set-CsDialInConferencingDtmfConfiguration -Identity "site:Redmond" -PrivateRollCallCommand $Null

Der Befehl in Beispiel 3 deaktiviert den Befehl zum Aufruf der Teilnehmerliste (die Möglichkeit zur Wiedergabe einer Liste aller Personen, die an der Konferenz teilnehmen) für den Standort. Um diesen Befehl zu deaktivieren, wird der Parameter "PrivateRollCallCommand" mit dem Parameterwert "$Null" angegeben. Somit kann diesem Befehl keine Taste zugeordnet werden, d. h., er ist für Benutzer nicht verfügbar.

-------------------------- Beispiel 4 ------------------------

Get-CsDialInConferencingDtmfConfiguration -Filter "site:*" | Set-CsDialInConferencingDtmfConfiguration -PrivateRollCallCommand $Null

Beispiel 4 ist eine Variante von Beispiel 3: In diesem Beispiel wird der Befehl zum Aufruf der Teilnehmerliste für alle DTMF-Einstellungen deaktiviert, die auf Standortebene konfiguriert wurden. Hierzu verwendet der Befehl zunächst Get-CsDialInConferencingDtmfConfiguration und den Parameter "Filter", um eine Auflistung aller auf Standortebene konfigurierten Einstellungen zurückzugeben. Mit dem Filterwert "site:*" werden die zurückgegebenen Daten auf die Einstellungen beschränkt, bei denen der Wert der Eigenschaft "Identity" mit der Zeichenfolge "site:" beginnt. Diese gefilterte Auflistung wird dann an das Cmdlet Set-CsDialInConferencingDtmfConfiguration weitergeleitet, das den Wert der Eigenschaft "PrivateRollCallCommand" auf Null ($Null) festlegt.