Get-CsRgsWorkflow
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen über Reaktionsgruppenworkflows zurück. Workflows legen die Aktionen fest, die bei Eingang eines Telefonanrufs bei der Reaktionsgruppenanwendung durchgeführt werden.
Syntax
Get-CsRgsWorkflow [-Identity <RgsIdentity>] [-Name <String>]
Detaillierte Beschreibung
Workflows sind wahrscheinlich das wichtigste Element der Reaktionsgruppenanwendung. Jeder Workflow ist eindeutig einer Telefonnummer zugeordnet; wenn jemand diese Nummer anruft, legt der Workflow fest, wie der Anruf verarbeitet wird. Beispielsweise kann der Anruf zur Beantwortung einer Reihe von Fragen an das interaktive Sprachantwortsystem weitergeleitet werden, sodass der Anrufer zur Eingabe weiterer Informationen aufgefordert wird ("Drücken Sie 1 für Hardwaresupport. Drücken Sie 2 für Softwaresupport."). Alternativ dazu kann der Anruf in eine Warteschleife gestellt und der Anrufer gehalten werden, bis ein Agent zum Entgegennehmen des Anrufs verfügbar ist. Auch die Verfügbarkeit von Agenten zur Anrufannahme wird vom Workflow vorgegeben: Mithilfe von Workflows werden sowohl Geschäftszeiten (die Wochentage und Tageszeiten, zu denen Agenten für die Annahme von Anrufen verfügbar sind) als auch Feiertage (Tage, an denen keine Agenten zur Anrufannahme bereitstehen) konfiguriert.
Das Cmdlet Get-CsRgsWorkflow bietet die Möglichkeit, Informationen zu allen Workflows abzurufen, die in Ihrer Organisation konfiguriert sind.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsRgsWorkflow 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 "Get-CsRgsWorkflow"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Rgs-ID |
Stellt entweder die ID des Diensts dar, in dem der Reaktionsgruppenworkflow gehostet wird, oder den vollständigen Identitätswert des Workflows selbst. Wenn Sie die Dienstidentität angeben (z. B. "service: ApplicationServer:atl-cs-001.litwareinc.com"), werden alle von diesem Dienst gehosteten Reaktionsgruppenworkflows zurückgegeben. Wenn Sie den Identitätswert des Workflows angeben, wird nur dieser eine Reaktionsgruppenworkflow zurückgegeben. Beachten Sie, dass der Identitätswert eines Workflows aus der Dienstidentität gefolgt von einer GUID besteht. Beispiel: service:ApplicationServer:atl-cs-001.litwareinc.com/1987d3c2-4544-489d-bbe3-59f79f530a83. Eine weitere Möglichkeit zur Rückgabe eines einzigen Reaktionsgruppenworkflows besteht darin, die Dienstidentität und den Parameter "Name" gefolgt vom Workflownamen anzugeben. Hiermit können Sie einen bestimmten Workflow abrufen, ohne die dem Workflow zugewiesene GUID kennen zu müssen. Wird Get-CsRgsWorkflow ohne Parameter aufgerufen, wird eine Auflistung aller in Ihrer Organisation konfigurierten Workflows zurückgegeben. |
Name |
Optional |
Zeichenfolge |
Eindeutiger Name, der dem Reaktionsgruppenworkflow bei seiner Erstellung zugewiesen wurde. |
Eingabetypen
Keine. Get-CsRgsWorkflow akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Get-CsRgsWorkflow werden Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsRgsWorkflow
Im vorstehenden Beispiel werden Informationen zu allen in Ihrer Organisation konfigurierten Workflows zurückgegeben. Hierzu wird Get-CsRgsWorkflow ohne Parameter aufgerufen.
-------------------------- Beispiel 2 --------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
In Beispiel 2 werden Informationen zu allen Workflows der Reaktionsgruppenanwendung zurückgegeben, die für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefunden wurden.
-------------------------- Beispiel 3 --------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty DefaultAction
Der Befehl in Beispiel 3 zeigt detaillierte Informationen über die Eigenschaft "DefaultAction" für jeden Reaktionsgruppenworkflow an, der für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefunden wurde. Hierzu werden mit Get-CsRgsWorkflow zunächst Informationen über alle Workflows zurückgegeben, die für "ApplicationServer:atl-cs-001.litwareinc.com" gefunden wurden. Diese Informationen werden dann an das Cmdlet Select-Object weitergeleitet, wodurch der in der Eigenschaft "DefaultAction" gespeicherte Wert erweitert wird. Wenn Sie den Wert von "DefaultAction" erweitern, werden Ihnen die einzelnen Eigenschaften des eingebetteten Objekts angezeigt, das in der Eigenschaft "DefaultAction" gespeichert ist.
-------------------------- Beispiel 4 --------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "European Sales Support"
Beispiel 4 gibt Informationen zu einem einzelnen Reaktionsgruppenworkflow zurück: dem Workflow "European Sales Support" in "ApplicationServer:atl-cs-001.litwareinc.com".
-------------------------- Beispiel 5 --------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.Language -eq "en-Us"}
Der Befehl in Beispiel 5 gibt Informationen über alle Reaktionsgruppenworkflows zurück, die US-Englisch als primäre Sprache verwenden. Hierzu ruft der Befehl zunächst Get-CsRgsWorkflow auf, um eine Auflistung aller Workflows zurückzugeben, die für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" zu finden sind. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Workflows auswählt, bei denen die Eigenschaft "Language" den Wert "en-US" (US-Englisch) aufweist.
-------------------------- Beispiel 6 --------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.CustomMusicOnHold -eq $Null}
Der vorstehende Befehl gibt alle Workflows für "ApplicationServer:atl-cs-001.litwareinc.com" zurück, deren Eigenschaft "CustomMusicOnHold" auf einen Nullwert ($Null) festgelegt wurde. (Anders ausgedrückt, der Befehl gibt Informationen über die Workflows zurück, denen keine benutzerdefinierte Musik zugewiesen wurde.) Hierzu verwendet der Befehl zunächst Get-CsRgsWorkflow, um eine Auflistung aller Workflows zurückzugeben, die für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" zu finden sind. Die zurückgegebenen Daten werden dann an das Cmdlet Where-Object weitergeleitet, das nur die Elemente herausfiltert, deren Eigenschaft "CustomMusicOnHold" einen Nullwert ($Null) aufweist (der Vergleichsoperator "-eq" steht für "equal to").