Set-CsRgsQueue
Letztes Änderungsdatum des Themas: 2012-03-23
Ändert eine bestehende Reaktionsgruppenwarteschleife. Mit der Reaktionsgruppenanwendung werden Telefonanrufe an eine Warteschleife übergeben und die Anrufe in einer Warteschleife platziert, bis ein Agent verfügbar wird.
Syntax
Set-CsRgsQueue -Instance <Queue> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 Sekunden) in der Warteschleife platziert sind.
Das Cmdlet Set-CsRgsQueue bietet eine Möglichkeit zum Ändern einer Reaktionsgruppenwarteschleife. Mit Set-CsRgsQueue können Sie die Warteschleife nicht direkt ändern. Das Cmdlet enthält beispielsweise keine Parameter zum Ändern des Schwellenwerts für den Überlauf oder die Aktion bei einem Überlauf. Wenn Sie eine Warteschleife ändern müssen, müssen Sie zunächst einen Objektverweis auf diese Warteschleife erstellen. Hierzu müssen Sie die gewünschte Warteschleife mit Get-CsRgsQueue abrufen und diese dann in einer Variablen speichern. Änderungen an der Warteschleife werden dann im Arbeitsspeicher durch Zuweisen neuer Werte zu den Warteschleifeneigenschaften vorgenommen. Nachdem Sie alle Änderungen durchgeführt haben, rufen Sie Set-CsRgsQueue auf, um diese erneut in die tatsächliche Reaktionsgruppenwarteschleife zu schreiben. Wenn Sie Set-CsRgsQueue nicht aufrufen, erfolgen die Änderungen nur im Arbeitsspeicher und gehen verloren, sobald Sie Windows PowerShell beenden oder die Objektverweisvariable löschen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-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 "Set-CsRgsQueue"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Instance |
Erforderlich |
Warteschleifenobjekt |
Objektverweis auf die zu ändernde Reaktionsgruppendienstwarteschleife. Ein Objektverweis wird normalerweise mithilfe des Cmdlets Get-CsRgsQueue und durch Zuweisen des zurückgegebenen Werts zu einer Variablen abgerufen. Mit diesem Befehl wird beispielsweise ein Objektverweis auf die Warteschleife "Help Desk" zurückgegeben und dieser Objektverweis in der Variablen "$x" gespeichert: $x = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" |
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.Rgs.Management.WritableSettings.Queue-Objekt Set-CsRgsQueue akzeptiert weitergeleitete Objektinstanzen der Reaktionsgruppenwarteschleife.
Rückgabetypen
Set-CsRgsQueue gibt keine Objekte oder Werte zurück. Stattdessen werden mit dem Cmdlet bestehende Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.Queue" geändert.
Beispiel
-------------------------- Beispiel 1 --------------------------
$x = Get-CsRgsQueue -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.OverflowCandidate = "NewestCall"
Set-CsRgsQueue -Instance $x
In Beispiel 1 wird die Eigenschaft "OverflowCandidate" für die Reaktionsgruppenwarteschleife geändert, die für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefunden wurde. Hierzu ruft der erste Befehl im Beispiel die angegebene Warteschleife (-Name "Help Desk") mithilfe von Get-CsRgsQueue aus "ApplicationServer:atl-cs-001.litwareinc.com" ab. Die abgerufene Warteschleife wird in der Variablen "$x" gespeichert.
Nach Abrufen der Warteschleife legt der zweite Befehl im Beispiel den Wert der Eigenschaft "OverflowCandidate" dieser virtuellen Warteschleife auf "NewestCall" fest. Im Anschluss an diesen Befehl schreibt der letzte Befehl diese Änderungen mithilfe von Set-CsRgsQueue in die tatsächliche Warteschleife "Help Desk". Bisher wurden die Änderungen nur im Arbeitsspeicher durchgeführt. Die tatsächliche Reaktionsgruppenwarteschleife für "ApplicationServer:atl-cs-001.litwareinc.com" bleibt bis zum Aufrufen von Set-CsRgsQueue unverändert.
-------------------------- Beispiel 2 --------------------------
$x = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Overflow Queue"
$w = New-CsRgsPrompt -TextToSpeechPrompt "Please hold while we transfer your call."
$y = New-CsRgsCallAction -Prompt $w -Action TransferToQueue -QueueID $x.Identity
$z = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$z.OverflowAction = $y
Set-CsRgsQueue -Instance $z
Die Befehle in Beispiel 2 veranschaulichen, wie Sie eine neue Anrufaktion für eine Reaktionsgruppe erstellen und diese Aktion einer bestehenden Reaktionsgruppenwarteschleife zuweisen können. Hierzu rufen Sie mit Get-CsRgsQueue zunächst die Reaktionsgruppenwarteschleife "Help Desk Overflow Queue" aus "ApplicationServer:atl-cs-001.litwareinc.com" ab. Informationen zu dieser Warteschleife sind in der Variablen "$x" gespeichert.
Nach dem Abrufen der Warteschlange wird mit dem Cmdlet New-CsRgsPrompt eine Text-zu-Sprache-Ansage erstellt, die in der Variablen "$w" gespeichert wird. Anschließend wird das Cmdlet New-CsRgsCallAction zum Erstellen einer neuen Anrufaktion verwendet. Diese 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). Diese neue Anrufaktion wird im Arbeitsspeicher erstellt und dann in der Variablen "$y" gespeichert.
Im nächsten Befehl wird die zu ändernde Warteschleife abgerufen, in diesem Beispiel die Warteschleife "Help Desk" für "ApplicationServer:atl-cs-001.litwareinc.com". Nachdem die Warteschleife mit "Get-CsRgsQueue" abgerufen wurde, wird das resultierende Objekt in der Variablen "$z" gespeichert.
Nach Abschluss des Vorgangs können Sie die neue Anrufaktion der "Help Desk Queue" zuweisen. Hierzu legen Sie den Wert der Eigenschaft "OverflowAction" auf "$y" fest. Diese Variable enthält die neu erstellte Anrufaktion.
Nach der Zuweisung der Anrufaktion wird im letzten Befehl des Beispiels Set-CsRgsQueue aufgerufen, um die Änderungen in die tatsächliche Instanz der Warteschleife "Help Desk" für "ApplicationServer:atl-cs-001.litwareinc.com" zu schreiben.