Get-CsRgsAgentGroup
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen zu den Reaktionsgruppen-Agentengruppen zurück, die für die Verwendung in Ihrer Organisation konfiguriert sind. 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 Warteschleife gerichtete Anrufen zuständig sind.
Syntax
Get-CsRgsAgentGroup [-Identity <RgsIdentity>] [-Name <String>]
Detaillierte Beschreibung
Wenn jemand eine der Reaktionsgruppenanwendung zugeordnete Telefonnummer anruft, bestimmt die Anwendung zunächst den Workflow, der 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). Alternativ kann der Anruf in einer Reaktionsgruppenwarteschleife platziert werden, bis eine Person verfügbar ist, die den Anruf entgegennehmen kann. 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 in der Agentengruppe "Help Desk", Kundensupportagenten dagegen in der Agentengruppe "Customer Support" zusammengefasst werden.
Mit dem Cmdlet Get-CsRgsAgentGroup können Informationen zu den Reaktionsgruppen-Agentengruppen zurückgegeben werden, die gegenwärtig in Ihrer Organisation verwendet werden (dies umfasst Informationen zu den Benutzern, die den einzelnen Agentengruppen zugeordnet wurden).
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsRgsAgentGroup lokal ausführen: RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsRgsAgentGroup"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Rgs-ID |
Stellt entweder den Identitätswert des Diensts, der die Reaktionsgruppen-Agentengruppe hostet, oder den vollständigen Identitätswert der Agentengruppe selbst dar. Wenn Sie die Dienstidentität angeben (z. B. "service:ApplicationServer:atl-cs-001.litwareinc.com"), werden alle von diesem Dienst gehosteten Agentengruppen zurückgegeben. Wenn Sie den Identitätswert der Gruppe angeben, wird nur die angegebene Agentengruppe zurückgegeben. Beachten Sie, dass der Identitätswert einer Agentengruppe aus der Dienstidentität besteht, auf die eine GUID folgt. Beispiel: service:ApplicationServer:atl-cs-001.litwareinc.com/1987d3c2-4544-489d-bbe3-59f79f530a83. Alternativ können Sie zum Zurückgeben einer einzelnen Gruppe die Dienstidentität angeben und dann den Parameter "Name" gefolgt vom Namen der Agentengruppe hinzufügen. Hiermit können Sie eine bestimmte Agentengruppe abrufen, ohne die dieser Gruppe zugewiesene GUID kennen zu müssen. Beim Aufrufen ohne Parameter gibt Get-CsRgsAgentGroup eine Auflistung aller für die Verwendung in Ihrer Organisation konfigurierten Agentengruppen zurück. |
Name |
Optional |
Zeichenfolge |
Eindeutiger Name, der der Agentengruppe bei der Erstellung zugewiesen wurde. |
Eingabetypen
Zeichenfolge. Get-CsRgsAgentGroup akzeptiert einen Zeichenfolgenwert, der den Identitätswert der Reaktionsgruppen-Agentengruppe darstellt.
Rückgabetypen
Mit Get-CsRgsAgentGroup werden Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsRgsAgentGroup
In Beispiel 1 werden alle Reaktionsgruppen-Agentengruppen zurückgegeben, die für die Verwendung innerhalb der Organisation konfiguriert sind. Hierzu wird Get-CsRgsAgentGroup ohne Parameter aufgerufen.
-------------------------- Beispiel 2 --------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
Mit dem vorstehenden Befehl werden alle für die Verwendung mit dem Dienst "ApplicationServer:atl-cs-001.litwareinc.com" konfigurierten Reaktionsgruppen-Agentengruppen zurückgegeben.
-------------------------- Beispiel 3 --------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
Der Befehl in Beispiel 3 gibt eine einzelne Reaktionsgruppen-Agentengruppe zurück: die Gruppe "Help Desk", die für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefunden wurde.
-------------------------- Beispiel 4 --------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -eq "RoundRobin"}
In Beispiel 4 werden Informationen für alle Reaktionsgruppen-Agentengruppen des Diensts "ApplicationServer:atl-cs-001.litwareinc.com" zurückgegeben, die die Roundrobin-Routingmethode verwenden. Hierzu verwendet der Befehl zunächst Get-CsRgsAgentGroup, um eine Auflistung aller für "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" den Wert "RoundRobin" aufweist.
-------------------------- Beispiel 5 --------------------------
Get-CsRgsAgentGroup -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -ne "RoundRobin"}
Der Befehl in Beispiel 5 ist eine Variante des Befehls in Beispiel 4. In diesem Fall werden jedoch Informationen für alle Reaktionsgruppen-Agentengruppen des Diensts "ApplicationServer:atl-cs-001.litwareinc.com" zurückgegeben, die nicht die Roundrobin-Routingmethode verwenden. Hierzu ruft der Befehl zunächst Get-CsRgsAgentGroup auf, um eine Auflistung aller für "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").