Remove-CsRgsAgentGroup
Letztes Änderungsdatum des Themas: 2012-05-21
Entfernt eine bestehende Reaktionsgruppen-Agentengruppe. Eine Agentengruppe ist eine Auflistung von Agenten, die einer Reaktionsgruppenwarteschleife zugewiesen ist. Bei Agenten handelt es sich um die Benutzer, die für die Entgegennahme von an eine bestimmte Warteschleife gerichtete Anrufen zuständig sind.
Syntax
Remove-CsRgsAgentGroup -Instance <AgentGroup> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Wenn jemand eine der Reaktionsgruppenanwendung zugeordnete Telefonnummer anruft, ermittelt der Dienst zunächst, welcher Workflow der gewählten Nummer entspricht. Gemäß der Konfiguration dieses Workflows wird der Anruf möglicherweise an das interaktive Sprachantwortsystem weitergeleitet, um einen Satz von Fragen zu beantworten (dem Anrufer werden Fragen wie z. B. "Haben Sie eine Frage zu Hardware- oder Softwaresupport?" gestellt). Stattdessen könnte der Anruf auch in einer Reaktionsgruppenwarteschleife aufgenommen werden. Der Anrufer verbleibt in der Warteschleife, bis eine für die Entgegennahme von Anrufen zuständige Person verfügbar wird. Die für die Entgegennahme von Anrufen zuständigen Personen werden als Agenten, und eine Gruppe von Agenten wird als Reaktionsgruppen-Agentengruppe bezeichnet. Agentengruppen sind Workflows zugeordnet und können außerdem Gruppen zugeordnet werden, die ihren Zuständigkeitsbereich reflektieren. Mitarbeiter des Helpdesks können beispielsweise in der Agentengruppe "Help Desk", Kundensupportagenten dagegen in der Agentengruppe "Customer Support" zusammengefasst werden.
Neue Agentengruppen werden mit dem Cmdlet New-CsRgsAgentGroup erstellt. Zum Löschen einer Agentengruppe können Sie das Cmdlet Remove-CsRgsAgentGroup aufrufen. Beachten Sie, dass mit diesem Cmdlet die gesamte Gruppe und alle in dieser enthaltenen Agenten gelöscht werden. Wenn Sie nur einen einzelnen Agenten aus einer Gruppe entfernen möchten, verwenden Sie stattdessen das Cmdlet Set-CsRgsAgentGroup.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-CsRgsAgentGroup 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-CsRgsAgentGroup"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Instance |
Erforderlich |
AgentGroup object |
Objektverweis auf die zu entfernende Agentengruppe. Beim Weiterleiten von Workflowobjekten an Remove-CsRgsAgentGroup können Sie den Parameter "Instance" weglassen. Zum Verwenden des Parameters "Instance" verwenden Sie Befehle wie diesen: $x = Get-CsRgsAgentGroup –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsAgentGroup –Instance $x Bei Angabe des Parameters "Instance" kann immer nur eine einzelne Agentengruppe entfernt werden. Dies bedeutet, dass Ihr Objektverweis ($x) nicht mehrere Agentengruppenobjekte enthalten kann. |
Force |
Optional |
Switch-Parameter |
Erzwingt das Entfernen der Agentengruppe. Wenn dieser Parameter angegeben wurde, wird die Agentengruppe ohne Warnung entfernt, selbst wenn sie von einem aktiven Workflow verwendet wird. Wenn dieser Parameter nicht angegeben wurde, werden Sie aufgefordert, das Löschen von Agentengruppen 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.AgentGroup-Objekt Remove-CsRgsAgentGroup akzeptiert weitergeleitete Objektinstanzen der Agentengruppe für die Reaktionsgruppe.
Rückgabetypen
Mit Remove-CsRgsAgentGroup werden vorhandene Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup" gelöscht.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsAgentGroup
Mit dem vorstehenden Befehl werden alle für die Verwendung mit dem Dienst "ApplicationServer:atl-cs-001.litwareinc.com" konfigurierten Reaktionsgruppen-Agentengruppen gelöscht. Hierzu gibt der Befehl mit Get-CsRgsAgentGroup zunächst alle Agentengruppen für "ApplicationServer:atl-cs-001.litwareinc.com" zurück. Diese Gruppen werden dann an das Cmdlet Remove-CsRgsAgentGroup weitergeleitet und von diesem entfernt.
-------------------------- Beispiel 2 --------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" | Remove-CsRgsAgentGroup
In Beispiel 2 wird eine einzelne Reaktionsgruppen-Agentengruppe entfernt: die Gruppe "Help Desk". Hierzu wird zunächst mithilfe des Cmdlets Get-CsRgsAgentGroup die Gruppe "Help Desk" (-Name "Help Desk") aus "ApplicationServer:atl-cs-001.litwareinc.com" zurückgegeben. Diese Gruppe wird dann an das Cmdlet Remove-CsRgsAgentGroup weitergeleitet und von diesem aus dem Dienst entfernt.
-------------------------- Beispiel 3 --------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -ne "RoundRobin"} | Remove-CsRgsAgentGroup
Mit Beispiel 3 werden alle Reaktionsgruppen-Agentengruppen für "ApplicationServer:atl-cs-001.litwareinc.com" gelöscht, die die Roundrobin-Routingmethode nicht verwenden. Hierzu wird zunächst Get-CsRgsAgentGroup aufgerufen, um eine Auflistung aller für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Agentengruppen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Gruppen herausfiltert, bei denen die Eigenschaft "RoutingMethod" nicht den Wert "RoundRobin" aufweist (der Vergleichsoperator "-ne" steht für "not equal to"). Die gefilterte Auflistung wird dann an das Cmdlet Remove-CsRgsAgentGroup weitergeleitet, das jedes Element in der Auflistung löscht.