Remove-CsRgsQueue
Letztes Änderungsdatum des Themas: 2012-03-23
Löscht 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
Remove-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 zur Beantwortung einer Frage weitergeleitet, 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 der Reaktionsgruppe 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.
Neben der Erstellung neuer Warteschleifen haben Sie auch die Möglichkeit, vorhandene Warteschleifen zu entfernen. Hierzu dient das Cmdlet Remove-CsRgsQueue. Beachten Sie, dass bei dem Versuch, eine Warteschleife zu entfernen, die derzeit einem aktiven Workflow zugeordnet ist, standardmäßig eine entsprechende Benachrichtigung erfolgt. In dieser Benachrichtigung müssen Sie bestätigen, dass Sie die Warteschleife wirklich löschen möchten. Außerdem wird Windows PowerShell angehalten (ohne eine Warteschleife zu löschen), bis Sie auf die Benachrichtigung reagiert haben. Fügen Sie den Parameter "Force" hinzu, um die Benachrichtigung außer Kraft zu setzen und die von einem aktiven Workflow verwendeten Warteschleifen zu löschen. Beispiel:
Get-CsRgsQueue –Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Remove-CsRgsQueue –Force
Remove-CsRgsQueue prüft stets, ob eine Warteschleife von einem aktiven Workflow verwendet wird, bevor diese Warteschleife gelöscht wird. Das Cmdlet prüft hingegen nicht, ob die Warteschleife von einer anderen Warteschleife entweder als Timeout- oder Überlaufwarteschleife verwendet wird. Dies bedeutet, dass es möglich ist, eine Warteschleife zu löschen, die von einer anderen Warteschleife benötigt wird. Aus diesem Grund sollten Sie mit dem Cmdlet Get-CsRgsQueue die Eigenschaften "OverflowAction" und "TimeoutAction" Ihrer anderen Reaktionsgruppenwarteschleifen prüfen, bevor Sie Remove-CsRgsQueue zum Löschen einer Warteschleife ausführen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-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 "Remove-CsRgsQueue"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Instance |
Erforderlich |
Warteschleifenobjekt |
Objektverweis auf die zu entfernende Warteschlange. Beim Weiterleiten von Workflowobjekten an Remove-CsRgsQueue können Sie den Parameter "Instance" weglassen. Wenn Sie den Parameter "Instance" verwenden möchten, wählen Sie Befehle wie den Folgenden: $x = Get-CsRgsQueue –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsQueue –Instance $x Bei Angabe des Parameters "Instance" kann immer nur eine einzelne Warteschlange entfernt werden. Dies bedeutet, dass Ihr Objektverweis ($x) nicht mehrere Warteschlangenobjekte enthalten kannn. |
Force |
Optional |
Switch-Parameter |
Erzwingt das Löschen einer Reaktionsgruppenwarteschleife. Wenn dieser Parameter angegeben wurde, wird die Warteschleife ohne Warnung entfernt, selbst wenn sie einem aktiven Workflow zugewiesen ist. Wenn dieser Parameter nicht angegeben wurde, werden Sie aufgefordert, das Löschen von Warteschleifen zu bestätigen, die zurzeit von einem aktiven Workflow verwendet werden. |
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 Remove-CsRgsQueue akzeptiert weitergeleitete Objektinstanzen der Reaktionsgruppenwarteschleife.
Rückgabetypen
Mit Remove-CsRgsQueue werden vorhandene Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.Queue" gelöscht.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsQueue
Der Befehl in Beispiel 1 löscht alle für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Reaktionsgruppenwarteschleifen. Hierzu verwendet der Befehl zunächst Get-CsRgsQueue, um eine Auflistung aller für "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Warteschleifen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Remove-CsRgsQueue weitergeleitet, das jede Warteschleife in der Auflistung löscht.
-------------------------- Beispiel 2 --------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Queue" | Remove-CsRgsQueue
In Beispiel 2 wird eine einzelne Reaktionsgruppenwarteschleife gelöscht: die Warteschleife "Help Desk Queue" im Dienst "ApplicationServer:atl-cs-001.litwareinc.com". Zum Löschen dieser Warteschleife wird Get-CsRgsQueue zusammen mit den Parametern "Identity" und "Name" aufgerufen. Die daraufhin zurückgegebene einzelne Warteschleife wird dann an das Cmdlet Remove-CsRgsQueue weitergeleitet und von diesem gelöscht.
-------------------------- Beispiel 3 --------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.OverflowCandidate -eq "NewestCall"} | Remove-CsRgsQueue
Der vorstehende Befehl löscht alle für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Reaktionsgruppenwarteschleifen, sofern für diese Warteschleifen die Eigenschaft "OverflowCandidate" auf "NewestCall" festgelegt ist. Hierzu wird zunächst Get-CsRgsQueue aufgerufen, um eine Auflistung aller für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Reaktionsgruppenwarteschleifen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Warteschleifen herausfiltert, bei denen die Eigenschaft "OverflowCandidate " den Wert "NewestCall" aufweist. Die gefilterte Auflistung wird anschließend an Remove-CsRgsQueue weitergeleitet, das jede Warteschleife in der Auflistung löscht.