New-CsRgsQueue
Letztes Änderungsdatum des Themas: 2012-03-23
Erstellt eine neue Reaktionsgruppenwarteschleife. Mit der Reaktionsgruppenanwendung werden Telefonanrufe an eine Warteschleife übergeben und die Anrufe in einer Warteschleife platziert, bis ein Agent verfügbar wird.
Syntax
New-CsRgsQueue -Parent <RgsIdentity> -Name <String> [-AgentGroupIDList <Collection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-OverflowAction <CallAction>] [-OverflowCandidate <NewestCall | OldestCall>] [-OverflowThreshold <Nullable>] [-TimeoutAction <CallAction>] [-TimeoutThreshold <Nullable>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Wenn jemand eine der Reaktionsgruppenanwendung zugeordnete Telefonnummer anruft, wird eine der beiden folgenden Aktionen durchgeführt: Der Anruf wird entweder an eine Frage weitergeleitet, die der Anrufer beantworten muss, bevor er fortfahren kann (z. B.: "Drücken Sie 1 für Hardwaresupport, drücken Sie 2 für Softwaresupport"), oder der Anruf wird in einer Warteschleife platziert, bis ein Agent verfügbar wird.
Anstelle einer einzelnen Warteschleife für alle Anrufe können Sie mit der Reaktionsgruppenanwendung mehrere Warteschleifen erstellen, die unterschiedlichen Workflows oder Agentengruppen zugeordnet werden können. Dies bedeutet, dass Warteschleifen unterschiedlich auf Ereignisse (wie beispielsweise die festgelegte Anzahl von Anrufen, die gleichzeitig in die Warteschleife aufgenommen werden können) bzw. auf Anrufer reagieren können, die seit einer bestimmten Zeit in der Warteschleife platziert sind.
Mit dem Cmdlet New-CsRgsQueue können Administratoren ganz einfach neue Reaktionsgruppenwarteschleifen erstellen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsRgsQueue 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-CsRgsQueue"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Parent |
Erforderlich |
Rgs-ID |
Dienst, von dem die neue Warteschleife gehostet wird. Beispiel: -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com". |
Name |
Erforderlich |
Zeichenfolge |
Eindeutiger Name, der der neuen Warteschleife zugewiesen werden muss. Die Kombination aus den Eigenschaften "Parent" und "Name" ermöglicht es Ihnen, Reaktionsgruppenwarteschleifen eindeutig zu identifizieren, ohne auf ihre GUID verweisen zu müssen. |
AgentGroupIdList |
Optional |
AgentGroup-Auflistung |
Der Identitätswert der Reaktionsgruppen-Agentengruppen, die der Warteschleife hinzugefügt werden sollen. Die Agentengruppenidentitäten können mit dem Cmdlet Get-CsRgsAgentGroup abgerufen werden. Ausführliche Informationen finden Sie in den Beispielen weiter unten in diesem Thema. Wenn ein Anruf an eine Warteschleife weitergeleitet wird, der keine Agentengruppen (bzw. Agentengruppen ohne Agenten) zugewiesen sind, wird die Verbindung automatisch getrennt. |
Description |
Optional |
Zeichenfolge |
Ermöglicht Administratoren, weitere Informationen zur Reaktionsgruppenwarteschleife bereitzustellen. |
OverflowAction |
Optional |
CallAction-Objekt |
Aktion, die bei Erreichen des Schwellenwerts für den Überlauf ausgeführt wird. Die Eigenschaft "OverflowAction" muss mithilfe des Cmdlets New-CsRgsCallAction erstellt werden. |
OverflowCandidate |
Optional |
PS-Listenmodifizierer |
Gibt an, auf welchen Anruf sich das Erreichen des Schwellenwerts für den Überlauf auswirkt. Die Eigenschaft "OverflowCandidate" muss auf einen der folgenden beiden Werte festgelegt werden: "NewestCall" "OldestCall" Der Standardwert lautet "NewestCall". |
OverflowThreshold |
Optional |
Ganze Zahl |
Anzahl der simultanen Anrufe, die zu einem bestimmten Zeitpunkt in der Warteschleife enthalten sein können, bevor die Überlaufaktion ausgelöst wird. "OverflowThreshold" kann auf einen beliebigen ganzzahligen Wert zwischen 0 und 1000 festgelegt werden. Der Standardwert lautet "Null", d. h., die Warteschleife kann jederzeit eine unbegrenzte Anzahl von Anrufen enthalten. |
TimeoutAction |
Optional |
CallAction-Objekt |
Die Aktion, die bei Erreichen des Timeoutschwellenwerts ausgeführt wird. Der Parameter "TimeoutAction" muss mithilfe des Cmdlets New-CsRgsCallAction erstellt werden. |
TimeoutThreshold |
Optional |
Ganze Zahl |
Die Zeitspanne (in Sekunden), während der ein Anruf in der Warteschleife verbleiben kann, bevor das Timeout erreicht wird. Zu diesem Zeitpunkt ergreift das System die vom Parameter "TimeoutAction" festgelegte Aktion. Der Timeoutschwellenwert kann eine Ganzzahl zwischen 10 und 65535 Sekunden (ca. 18 Stunden) sein (der Anfangs- und Endwert gehören zu dieser Zeitspanne). Der Standardwert ist ein Nullwert, d. h., für die Warteschleife ist kein Timeout festgelegt. |
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. |
Eingabetypen
Keine. New-CsRgsQueue akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit New-CsRgsQueue werden neue Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.Queue" erstellt.
Beispiel
-------------------------- Beispiel 1 --------------------------
$x = New-CsRgsCallAction -Action TransferToVoicemailUri -Uri "sip:+14255551298@litwareinc.com"
New-CsRgsQueue -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -OverflowCandidate "OldestCall" -OverflowAction $x -OverflowThreshold 25
In Beispiel 1 wird eine neue Reaktionsgruppenwarteschleife für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" erstellt. Der erste Befehl im Beispiel verwendet das Cmdlet New-CsRgsCallAction zum Erstellen einer Anrufaktion für die Warteschleife. In diesem Beispiel werden Anrufe bei jedem Überschreiten des Überlaufschwellenwerts an Voicemail weitergeleitet. Hier wird der Parameter "Action" auf "TransferToVoicemailUri" und die Eigenschaft "URI" auf die SIP-URI für Voicemail "sip:+14255551298@litwareinc.com" festgelegt.
Nach der Konfiguration der Anrufaktion (die in der Variablen "$x" gespeichert wird), dient New-CsRgsQueue zum Erstellen der neuen Warteschleife mit dem Namen "Help Desk". Zusätzlich zur Angabe des Parameters "OverflowAction" konfiguriert dieser Befehl auch Werte für die Eigenschaften "OverflowCandidate" und "OverflowThreshold".