New-CsRgsCallAction

Syntax

New-CsRgsCallAction -Action <Nullable> [-Prompt <Prompt>] [-Question <Question>] [-QueueID <Nullable>] [-Uri <String>]

Detaillierte Beschreibung

Wenn jemand eine der Reaktionsgruppenanwendung zugeordnete Telefonnummer anruft, schlägt die Anwendung den Workflow nach, der der gewählten Nummer entspricht. Sobald der Workflow gefunden ist, prüft der Dienst, ob der Anruf außerhalb der Geschäftszeiten oder an einem Feiertag eingegangen ist. In diesem Fall führt der Dienst die festgelegte Aktion für Anrufe aus, die außerhalb der Geschäftszeiten oder an einem Feiertag eingehen. (Beispielsweise wird der Anruf direkt an die Voicemail weitergeleitet.) Wird der Anruf während der Geschäftszeiten angenommen, führt die Reaktionsgruppenanwendung die vorkonfigurierte Aktion für Anrufe aus, die während der Geschäftszeiten eingehen. All diese Aktionen werden im Voraus festgelegt und mithilfe des Cmdlets New-CsRgsCallAction erstellt. New-CsRgsCallAction ermöglicht das Aufnehmen von Anrufen in einer Reaktionsgruppenwarteschleife, die Weiterleitung von Anrufen an Voicemail, eine SIP-Adresse oder eine Festnetztelefonnummer (Public Switched Telephone Network, PSTN), die Weiterleitung von Anrufen an eine Frage der interaktiven Sprachantwort oder die Beendigung von Anrufen.

Wenn Sie New-CsRgsCallAction verwenden, ändern Sie nicht direkt die Eigenschaften eines Workflows, einer Warteschleife oder eines anderen Elements der Reaktionsgruppenanwendung. Stattdessen liegt die von Ihnen neu erstellte Anrufaktion zunächst nur im Arbeitsspeicher vor und muss in einer Objektverweisvariablen gespeichert werden (z. B. $x). Wenn Sie zu gegebenem Zeitpunkt beispielsweise die Eigenschaft "DefaultAction " eines Workflows ändern möchten, weisen Sie diesen Objektverweis der Eigenschaft entsprechenden Eigenschaft zu. Beispiel:

-DefaultAction $x

Wichtig ist der Hinweis, dass der Eigenschaft "DefaultAction" nur die beiden Anrufaktionen "TransferToQueue" und "TransferToQuestion" zugewiesen werden können. Alle anderen Anrufaktionen mit Ausnahme von "TransferToQueue" und "TransferToQuestion" sind für Aktionen gültig, die an Feiertagen oder außerhalb der Geschäftszeiten erfolgen können. Darüber hinaus können alle Anrufaktionen außer "TransferToQuestion" für Warteschleifentimeouts und -überläufe verwendet werden.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsRgsCallAction lokal ausführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Da dieses Cmdlet jedoch ein arbeitsspeicherinternes Objekt erstellt und selbst keine Änderungen am System durchführt, kann es praktisch von jedem Benutzer ausgeführt werden. 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-CsRgsCallAction"}

Parameter

Eingabetypen

Keine. New-CsRgsCallAction akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit New-CsRgsCallAction werden neue Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.CallAction" erstellt.

Beispiel

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

$x = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Overflow"
$z = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"

$w = New-CsRgsPrompt -TextToSpeechPrompt "Please hold while we transfer your call."
$y = New-CsRgsCallAction -Prompt $w -Action TransferToQueue -QueueID $x.Identity
$z.OverflowAction = $y
Set-CsRgsQueue $z

Die Befehle in Beispiel 1 veranschaulichen, wie Sie eine neue Anrufaktion für eine Reaktionsgruppe erstellen und diese Aktion einer bestehenden Reaktionsgruppenwarteschleife zuweisen können. In diesem Fall bestimmt die Anrufaktion, was geschieht, wenn der Überlauf der Warteschleife erreicht ist. Hierzu rufen Sie mit Get-CsRgsQueue zunächst die Warteschleife "Help Desk Overflow Queue" der Reaktionsgruppenanwendung aus "ApplicationServer:atl-cs-001.litwareinc.com" ab. Informationen in dieser Warteschleife werden anschließend in der Variablen "$x" gespeichert. Ein ähnlicher Befehl wird zum Abrufen der Warteschleife "Help Desk" verwendet. Die dazugehörigen Informationen werden in der Variablen "$z" gespeichert.

Nach dem Abrufen der Warteschleifen wird mit dem Cmdlet New-CsRgsPrompt eine Text-zu-Sprache-Ansage erstellt, die die neue Anrufaktion begleitet. Diese neue Anrufaktion wird anschließend durch Ausführen des Cmdlets New-CsRgsCallAction erstellt. Die Anrufaktion wird drei Parametern zugewiesen: "Prompt" (die von der Anrufaktion verwendete Benachrichtigung), "Action" (der angibt, was beim Auslösen der neuen Anrufaktion geschieht; der Parameterwert "TransferToQueue" bedeutet, dass der Anruf an eine andere Reaktionsgruppenwarteschleife weitergeleitet wird), und "QueueID", die alternative Warteschleife, an die der Anruf weitergeleitet wird ("$x.Identity", die Variable, die den Identitätswert der Warteschleife "Help Desk Overflow Queue" angibt). Die neue Anrufaktion wird im Arbeitsspeicher erstellt und dann in der Variablen "$y" gespeichert.

Nun können Sie die neue Anrufaktion der Warteschleife "Help Desk" zuweisen. Hierzu legen Sie den Wert der Eigenschaft "OverflowAction" auf "$y" fest. Diese Variable enthält die neu erstellte Anrufaktion. Wenn es bei der Warteschleife "Help Desk" zu einem "Überlauf" kommt (d. h. die maximal zulässige Anzahl von Anrufern erreicht ist), werden nachfolgende Anrufe automatisch an die Warteschleife "Help Desk Overflow Queue" weitergeleitet.

Im letzten Befehl im Beispiel wird schließlich Set-CsRgsQueue aufgerufen, um die Änderungen in die tatsächliche Instanz der Warteschleife "Help Desk Overflow Queue" für "ApplicationServer:atl-cs-001.litwareinc.com" zu schreiben.

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

$w = New-CsRgsPrompt -TextToSpeechPrompt "Please hold while we transfer your call."
$y = New-CsRgsCallAction -Prompt $w -Action TransferToPSTN -Uri "sip:+14255551298@litwareinc.com"
$z = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Queue"
$z.OverflowAction = $y
Set-CsRgsQueue $z

Die Befehl in Beispiel 2 ähneln den Befehlen in Beispiel 1. In Beispiel 2 leitet die neue Anrufaktion den Anruf an eine Festnetznummer (PSTN) weiter. Hierzu wird die Eigenschaft "Action" der neuen Anrufaktion auf "TransferToPSTN" und die Eigenschaft "Uri" auf "sip:+14255551298@litwareinc.com" festgelegt.

Siehe auch

Weitere Ressourcen

New-CsRgsQueue
Set-CsRgsQueue