New-CsDialInConferencingDtmfConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Erstellt eine neue 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

New-CsDialInConferencingDtmfConfiguration -Identity <XdsIdentity> [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-InMemory <SwitchParameter>] [-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, 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.

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. Sie können z. B. eine neue Auflistung von Einstellungen für den Standort "Redmond" (und nur für den Standort "Redmond") erstellen, für die die Taste 4 anstatt der Taste 6 für die Stummschaltung oder Aufhebung der Stummschaltung verwendet wird. Beachten Sie, dass alle Einstellungen, die Sie auf Standortebene konfigurieren, Vorrang vor den auf globaler Ebene konfigurierten Einstellungen haben. Daher verwenden Benutzer am Standort "Redmond" die Taste 4 als Stummschaltungstaste, auch wenn durch die globalen Einstellungen die Taste 6 für die Stummschaltung und Aufhebung der Stummschaltung verwendet wird.

Sie können pro Standort nur eine Auflistung von DTMF-Einstellungen und nur eine globale Auflistung verwenden. Angenommen, Sie verfügen bereits über eine Auflistung mit dem Identitätswert "site:Redmond" und versuchen, diesen Befehl auszuführen:

New- CSDialInConferencingDtmfConfiguration –Identity site:Redmond

Bei Ausführung des Befehls tritt ein Fehler auf, da die Auflistung "site:Redmond" bereits vorhanden ist. Wenn Sie die Auflistung für den Standort "Redmond" ändern möchten, verwenden Sie entweder das Cmdlet Set-CSDialInConferencingDtmfConfiguration, oder entfernen Sie die vorhandene Auflistung, und erstellen Sie eine neue Auflistung mit dem Identitätswert "site:Redmond".

Beachten Sie beim Konfigurieren von Werten für die DTMF-Befehle zwei Dinge: Sie können zum einen nur die numerischen Tasten 0 bis 9 und das Sternchen (*) verwenden, andere Tasten auf Ihrer Tastatur (z. B. die Taste #) sind nicht zulässig. (Es gilt eine Ausnahme: "CommandCharacter" akzeptiert nur die Sternchen- [*] oder die Rautetaste [#].) 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 im selben Befehl für "AudienceMuteCommand" 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 New-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 "New-CsDialInConferencingDtmfConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID, die einer neuen Auflistung von DTMF-Konfigurationseinstellungen zugewiesen werden soll. Da Sie neue Auflistungen nur auf Standortebene erstellen können, weist der Identitätswert immer das Präfix "site:" auf, gefolgt vom Standortnamen, z. B. "site:Redmond".

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 oder die Stummschaltung anderer Personen aufzuheben (d. h. alle Personen außer dem Referenten werden stummgeschaltet oder deren Stummschaltung wird aufgehoben). Die Standardtaste lautet 4.

CommandCharacter

Optional

Zeichenfolge

Gibt die Taste an, die zu Beginn eines Befehls gedrückt wird. Die Standardtaste ist das Sternchen (*). Neben dieser Taste ist nur der Wert # zulässig.

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 dieser Konferenz erst wieder neue Teilnehmer 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

Optional

Switch-Parameter

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

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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

Keine. New-CsDialInConferencingDtmfConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Erstellt neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration".

Beispiel

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

New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -MuteUnmuteCommand 4 -AudienceMuteCommand 6

Der Befehl in Beispiel 1 erstellt einen neuen Satz von DTMF-Konfigurationseinstellungen für den Standort "Redmond". In diesem Beispiel wird die Eigenschaft "MuteUnmuteCommand" auf 4 und die Eigenschaft "AudienceMuteCommand" auf den Wert 6 festgelegt.

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

New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -AdmitAll $Null

Mit dem vorstehenden Befehl wird ein neuer Satz von DTMF-Konfigurationseinstellungen für den Standort "Redmond" erstellt. In diesem Beispiel wird die Eigenschaft "AdmitAll" deaktiviert, indem der Parameter "AdmitAll" verwendet und der Parameterwert auf "$Null" festgelegt wird.

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

$x = New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -InMemory
$x.AdmitAll = $Null
$x.MuteUnmuteCommand = 4 
$x.AudienceMuteCommand = 6
Set-CSDialInConferencingDtmfConfiguration -Instance $x

In Beispiel 3 wird dargestellt, wie Sie mit dem Parameter "InMemory" eine nur im Arbeitsspeicher vorhandene Instanz einer Auflistung von DTMF-Konfigurationseinstellungen erstellen, diese Einstellungen ändern und dann mit Set-CSDialInConferencingDtmfConfiguration eine tatsächliche Auflistung mit dem Identitätswert "site:Redmond" erstellen können. Dazu wird mit dem ersten Befehl im Beispiel eine nur im Arbeitsspeicher vorhandene Instanz einer Auflistung von DTMF-Konfigurationseinstellungen erstellt, die in der Variablen "$x" gespeichert wird. Diese Einstellungen sind nur im Arbeitsspeicher vorhanden. Wenn Sie Windows PowerShell schließen oder die Variable "$x" löschen, gehen die Einstellungen verloren und werden nicht auf den Standort "Redmond" angewendet.

Mit den nächsten drei Befehlen werden die Eigenschaften dieser "virtuellen" Auflistung von DTMF-Einstellungen geändert: Mit den Befehlen 2, 3 und 4 werden "AdmitAll", "MuteUnMuteCommand" bzw. "AudienceMuteCommand" neue Werte zugewiesen. Im letzten Befehl werden Set-CSDialInConferencingDtmfConfiguration und der Parameter "Instance" verwendet, um die in "$x" gespeicherte virtuelle Auflistung in eine tatsächlich vorhandene Auflistung von Einstellungen zu konvertieren, die für den Standort "Redmond" konfiguriert ist.