Remove-CsRgsWorkflow
Letztes Änderungsdatum des Themas: 2012-03-23
Löscht einen bestehenden Reaktionsgruppenworkflow. Workflows legen die Aktionen fest, die bei Eingang eines Telefonanrufs bei der Reaktionsgruppenanwendung durchgeführt werden.
Syntax
Remove-CsRgsWorkflow -Instance <Workflow> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Workflows sind eines der wichtigsten Elemente in 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: Workflows dienen zum Verwalten von Geschäftszeiten (die Wochentage und die Uhrzeiten, an denen Agenten zur Entgegennahme von Telefonanrufen zur Verfügung stehen) und der Feiertage (Tage, an denen keine Agenten erreichbar sind).
Neue Workflows werden mit dem Cmdlet New-CsRgsWorkflow erstellt. Erstellte Workflows können zu einem späteren Zeitpunkt mithilfe von Remove-CsRgsWorkflow gelöscht werden. Beachten Sie, dass ein Workflow beim Löschen vollständig aus der Reaktionsgruppenanwendung entfernt wird. Verwenden Sie Remove-CsRgsWorkflow nicht, wenn ein Workflow nur vorübergehend deaktiviert werden soll. Wählen Sie in diesem Fall das Cmdlet Set-CsRgsWorkflow zum Deaktivieren (und späteren Reaktivieren) des Workflows.
Bei dem Versuch, einen aktiven Workflow zu löschen, fordert Remove-CsRgsWorkflow Sie auf zu bestätigen, dass der Workflow wirklich gelöscht werden soll. Remove-CsRgsWorkflow führt keine weiteren Schritte aus, bis Sie auf die Benachrichtigung reagiert haben. Verwenden Sie den Parameter "Force", um die Benachrichtigung außer Kraft zu setzen und einen aktiven Workflow ohne Benutzereingriff zu löschen. Beispiel:
Get-CsRgsWorkflow –Identity "service:ApplicationServer:atl-cs-001.litwareinc.com " | Remove-CsRgsWorkflow –Force
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-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 "Remove-CsRgsWorkflow"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Instance |
Optional |
Workflow-Objekt |
Objektverweis auf den zu entfernenden Workflow. Beim Weiterleiten von Workflowobjekten an Remove-CsRgsWorkflow können Sie den Parameter "Instance" weglassen. Wenn Sie den Parameter "Instance" verwenden möchten, wählen Sie Befehle wie den Folgenden: $x = Get-CsRgsWorkflow –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsWorkflow –Instance $x Bei Angabe des Parameters "Instance" kann immer nur ein einzelner Workflow entfernt werden. Dies bedeutet, dass Ihr Objektverweis ($x) nicht mehrere Workflowobjekte enthalten kann. |
Force |
Optional |
Switch-Parameter |
Erzwingt das Löschen des Workflows. Wenn dieser Parameter angegeben wurde, wird der Workflow ohne Warnung entfernt, selbst wenn er derzeit aktiv ist. Wenn dieser Parameter nicht angegeben wurde, werden Sie aufgefordert, das Löschen von aktiven Workflows zu bestätigen. |
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.Workflow-Objekt. Remove-CsRgsWorkflow akzeptiert weitergeleitete Objektinstanzen des Reaktionsgruppenworkflows.
Rückgabetypen
Mit Remove-CsRgsWorkflow werden vorhandene Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow" gelöscht.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsRgsWorkflow -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsWorkflow
Mit Beispiel 1 werden alle Reaktionsgruppenworkflows aus dem Dienst "ApplicationServer:atl-cs-001.litwareinc.com" entfernt. Hierzu ruft der Befehl zunächst Get-CsRgsWorkflow auf, um eine Auflistung aller für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Workflows zurückzugeben. Diese Auflistung wird dann an Remove-CsRgsWorkflow weitergeleitet, das jeden Workflow in der Auflistung löscht.
-------------------------- Beispiel 2 --------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Workflow" | Remove-CsRgsWorkflow
Der Befehl in Beispiel 2 löscht einen einzelnen Reaktionsgruppenworkflow: den Workflow "Help Desk Workflow", der über den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" bereitgestellt wird. Hierzu wird zunächst mithilfe des Cmdlets Get-CsRgsWorkflow der Workflow "Help Desk Workflow" aus dem Dienst "ApplicationServer:atl-cs-001.litwareinc.com" zurückgegeben. Dieser Workflow dann an das Cmdlet Remove-CsRgsWorkflow weitergeleitet und von diesem gelöscht.
-------------------------- Beispiel 3 --------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.Language -eq "en-us"} | Remove-CsRgsWorkflow
Mit dem vorstehenden Befehl werden alle Workflows in US-englischer Sprache aus dem Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gelöscht. Hierzu werden mithilfe von Get-CsRgsWorkflow zunächst alle für "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Workflows abgerufen. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Workflows auswählt, bei denen die Sprache US-Englisch (en-us) ist. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CsRgsWorkflow weitergeleitet, um sämtliche Elemente in der Auflistung zu löschen.
-------------------------- Beispiel 4 --------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.CustomMusicOnHoldFile -ne $Null} | Remove-CsRgsWorkflow
Der Befehl in Beispiel 4 löscht alle Reaktionsgruppenworkflows aus dem Dienst "ApplicationServer:atl-cs-001.litwareinc.com", bei denen ein Wert für die Eigenschaft "CustomMusicOnHoldFile" festgelegt ist. Hierzu verwendet der Befehl zunächst Get-CsRgsWorkflow, um eine Auflistung aller für den Dienst "ApplicationServer:atl-cs-001.litwareinc.com" gefundenen Workflows zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Workflows herausfiltert, bei denen die Eigenschaft "CustomMusicOnHoldFile" keinen Nullwert aufweist (der Vergleichsoperator "-ne" steht für "not equal to"). (Wenn die Eigenschaft keinen Nullwert aufweist, wurde für diesen Workflow benutzerdefinierte Musik definiert.) Diese gefilterte Auflistung wird anschließend an das Cmdlet Remove-CsRgsWorkflow weitergeleitet, um sämtliche Elemente in der Auflistung zu löschen.