Remove-CsRgsWorkflow
上次修改主題的時間： 2012-03-23
刪除現有的回應群組工作流程。工作流程可決定 回應群組應用程式 接到電話時採取的動作。
語法
Remove-CsRgsWorkflow -Instance <Workflow> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
工作流程是回應群組應用程式中的關鍵元素。每個工作流程只會與一個電話號碼產生關聯，當有人撥打該號碼時，工作流程便會決定如何處理這通電話。例如，系統會將電話路由傳送至一系列的互動語音回應 (IVR) 問題，這些問題會提示來電者輸入額外的資訊 (「硬體支援請按 1)。如需要軟體支援，請按 2。」)或者，來電可能會被放在佇列中並保留來電者，直到專員可接聽來電。專員是否可接聽電話的狀態，也是由工作流程指定的：工作流程可用來維護營業時間 (一星期的哪幾天和哪些時段會有專員接聽電話) 與假日 (專員無法接聽電話的日子)。
使用 New-CsRgsWorkflow 指令程式可建立新的工作流程。這些工作流程建立之後，日後可使用 Remove-CsRgsWorkflow 刪除。請注意，當您刪除工作流程時，工作流程會從 回應群組應用程式 完全移除。如果要暫時停用工作流程，請勿使用 Remove-CsRgsWorkflow；請改用 Set-CsRgsWorkflow 指令程式來停用 (日後再重新啟用) 工作流程。
如果您嘗試刪除作用中的工作流程，Remove-CsRgsWorkflow 會提示您確認您是否真的要刪除工作流程；在回應提示之前，Remove-CsRgsWorkflow 不會採取進一步動作。若要略過此提示，以無訊息的方式刪除作用中的工作流程，請使用 Force 參數。例如：
Get-CsRgsWorkflow –Identity "service:ApplicationServer:atl-cs-001.litwareinc.com " | Remove-CsRgsWorkflow –Force
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsRgsWorkflow Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsRgsWorkflow"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Instance |
選用 |
工作流程物件 |
指向要移除之工作流程的物件參考。將工作流程物件傳送到 Remove-CsRgsWorkflow 時，您可以省略 Instance 參數。 若要使用 Instance 參數，請使用類似下列的命令： $x = Get-CsRgsWorkflow –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsWorkflow –Instance $x 請注意，使用 Instance 參數時，您一次只能移除一個工作流程。這表示物件參考 ($x) 不能包含多個工作流程物件。 |
Force |
選用 |
切換參數 |
強制移除工作流程。如果此參數存在，即使工作流程目前處於作用狀態，它仍然會被刪除而不會有警告。如果此參數不存在，則系統會要求您確認是否要刪除所有作用中的工作流程。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow 物件。Remove-CsRgsWorkflow 接受管線傳送的回應群組工作流程物件執行個體。
傳回類型
Remove-CsRgsWorkflow 會刪除 Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow 物件的現有執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsRgsWorkflow -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsWorkflow
範例 1 會從 ApplicationServer:atl-cs-001.litwareinc.com 服務移除所有回應群組工作流程。如果要執行這項作業，命令會先呼叫 Get-CsRgsWorkflow 傳回在 ApplicationServer:atl-cs-001.litwareinc.com 上找到之所有工作流程的集合。該集合便會被傳送到 Remove-CsRgsWorkflow，刪除集合中的每一個工作流程。
-------------------------- 範例 2 ------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Workflow" | Remove-CsRgsWorkflow
範例 2 所示的命令會刪除單一回應群組工作流程：位於 ApplicationServer:atl-cs-001.litwareinc.com 服務上，名為 "Help Desk Workflow" 的工作流程。為達成此目的，先使用 Get-CsRgsWorkflow 從服務 ApplicationServer:atl-cs-001.litwareinc.com 傳回名為 Help Desk Workflow 的工作流程。該工作流程接著會被傳送到 Remove-CsRgsWorkflow，並予以刪除。
-------------------------- 範例 3 ------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.Language -eq "en-us"} | Remove-CsRgsWorkflow
上述命令會從 ApplicationServer:atl-cs-001.litwareinc.com 服務刪除所有語言為美國英文的工作流程。如果要執行這項作業，會先使用 Get-CsRgsWorkflow 擷取在 ApplicationServer:atl-cs-001.litwareinc.com 上找到的所有工作流程。接著，此集合便會傳送到 Where-Object 指令程式，此指令程式只會選取語言等於 U.S. English (en-us) 的工作流程。接下來經過篩選的集合會被傳送到 Remove-CsRgsWorkflow 指令程式，刪除集合中的每一個項目。
-------------------------- 範例 4 ------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.CustomMusicOnHoldFile -ne $Null} | Remove-CsRgsWorkflow
範例 4 所示的命令會從 ApplicationServer:atl-cs-001.litwareinc.com 服務刪除已設定有 CustomMusicOnHoldFile 值的所有回應群組工作流程。為了完成這項作業，命令會先使用 Get-CsRgsWorkflow 傳回在 ApplicationServer:atl-cs-001.litwareinc.com 上找到的所有工作流程集合。接著，此集合傳送到 Where-Object 指令程式，此指令程式只會選取 CustomMusicOnHoldFile 內容不等於 Null 值的工作流程。(屬性不等於 Null 值表示已為此工作流程自訂音樂。)接下來經過篩選的集合會被傳送到 Remove-CsRgsWorkflow，這會移除集合中的每一個項目。