Get-CsRgsQueue
Letztes Änderungsdatum des Themas: 2012-03-23
Ruft Informationen zu den in Ihrer Organisation verwendeten Reaktionsgruppenwarteschleifen ab. Mit der Reaktionsgruppenanwendung werden Telefonanrufe an eine Warteschleife übergeben und die Anrufe in einer Warteschleife platziert, bis ein Agent verfügbar wird.
Syntax
Get-CsRgsQueue [-Identity <RgsIdentity>] [-Name <String>]
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 Sekunden) in der Warteschleife gehalten werden.
Das Cmdlet Get-CsRgsQueue bietet die Möglichkeit, Informationen zu den für die Verwendung in Ihrer Organisation konfigurierten Reaktionsgruppenwarteschleifen zurückzugeben.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsRgsQueue 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-CsRgsQueue"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Rgs-ID |
Repräsentiert entweder den Identitätswert des Diensts, der die Reaktionsgruppenwarteschleife hostet, oder den vollständigen Identitätswert der Warteschleife selbst. Wenn Sie die Dienstidentität angeben (z. B. "service:ApplicationServer:atl-cs-001.litwareinc.com"), werden alle von diesem Dienst gehosteten Reaktionsgruppenwarteschleifen zurückgegeben. Wenn Sie den Identitätswert der Warteschleife angeben, wird nur die angegebene Reaktionsgruppenwarteschleife zurückgegeben. Beachten Sie, dass der Identitätswert einer Warteschleife aus der Dienstidentität gefolgt von einer GUID besteht, z. B.: service:ApplicationServer:atl-cs-001.litwareinc.com/1987d3c2-4544-489d-bbe3-59f79f530a83. Eine weitere Möglichkeit zur Rückgabe einer einzigen Reaktionsgruppenwarteschleife besteht darin, die Dienstidentität und den Parameter "Name" gefolgt vom Warteschleifennamen anzugeben. So können Sie eine bestimmte Reaktionsgruppenwarteschleife abrufen, ohne dass Ihnen die dieser zugewiesene GUID bekannt ist. Wenn Get-CsRgsQueue ohne Parameter aufgerufen wird, werden alle für die Verwendung in Ihrer Organisation konfigurierten Reaktionsgruppenwarteschleifen zurückgegeben. |
Name |
Optional |
Zeichenfolge |
Eindeutiger Name, der der Reaktionsgruppenwarteschleife bei ihrer Erstellung zugewiesen wurde. |
Eingabetypen
Zeichenfolge. Get-CsRgsQueue akzeptiert einen Zeichenfolgenwert, der den Identitätswert der Reaktionsgruppenwarteschleife darstellt.
Rückgabetypen
Mit Get-CsRgsQueue werden Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.Queue" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
Der vorstehende Befehl gibt Informationen zu allen für die Verwendung in der Organisation konfigurierten Reaktionsgruppenwarteschleifen zurück. Hierzu wird Get-CsRgsQueue ohne Parameter aufgerufen.
-------------------------- Beispiel 2 --------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
Der Befehl in Beispiel 2 gibt Informationen zu allen über den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" bereitgestellten Reaktionsgruppenwarteschleifen zurück.
-------------------------- Beispiel 3 --------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
In Beispiel 3 wird nur eine einzelne Reaktionsgruppenwarteschleife zurückgegeben: die Warteschleife "Help Desk" im Dienst "ApplicationServer:atl-cs-001.litwareinc.com".
-------------------------- Beispiel 4 --------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty TimeoutAction
Der Befehl in Beispiel 4 zeigt ausführliche Informationen zur Eigenschaft "TimeoutAction" zu allen für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Reaktionsgruppenwarteschleifen an. Hierzu werden mit Get-CsRgsQueue zunächst Informationen zu allen Warteschleifen zurückgegeben, die für "ApplicationServer:atl-cs-001.litwareinc.com" gefunden wurden. Diese Informationen werden dann an das Cmdlet Select-Object übergeben, wodurch der in der Eigenschaft "TimeoutAction" gespeicherte Wert "erweitert" wird. Wenn Sie die Eigenschaft "TimeoutAction" erweitern, werden Ihnen die einzelnen Eigenschaften des eingebetteten Objekts angezeigt, die den Eigenschaftswert bilden: "Prompt", "TargetQuestion", "Target", "TargetQueueID" und "TargetUri".
-------------------------- Beispiel 5 --------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.OverflowCandidate -eq "NewestCall"}
Der vorstehende Befehl gibt Informationen zu allen Reaktionsgruppenwarteschleifen für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" zurück, für die die Eigenschaft "OverflowCandidate" auf den Wert "NewestCall" festgelegt ist. Hierzu verwendet der Befehl zunächst Get-CsRgsQueue, um eine Auflistung aller für den angegebenen Dienst 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.