New-CsRgsWorkflow
上次修改主題的時間： 2012-03-23
建立新的回應群組工作流程。工作流程可決定回應群組應用程式接到電話時採取的動作。
語法
New-CsRgsWorkflow -Parent <RgsIdentity> -Name <String> -PrimaryUri <Uri> [-Active <$true | $false>] [-Anonymous <$true | $false>] [-BusinessHoursID <Nullable>] [-Confirm [<SwitchParameter>]] [-CustomMusicOnHoldFile <AudioFile>] [-DefaultAction <CallAction>] [-Description <String>] [-DisplayNumber <String>] [-EnabledForFederation <$true | $false>] [-Force <SwitchParameter>] [-HolidayAction <CallAction>] [-HolidaySetIDList <Collection>] [-InMemory <SwitchParameter>] [-Language <String>] [-LineUri <Uri>] [-NonBusinessHoursAction <CallAction>] [-TimeZone <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
工作流程是回應群組應用程式中的關鍵元素。每個工作流程只會與一個電話號碼產生關聯，當有人撥打該號碼時，工作流程便會決定如何處理這通電話。例如，系統會將電話路由傳送至一系列的互動語音回應 (IVR) 問題，這些問題會提示來電者輸入額外的資訊 (「硬體支援請按 1。如需要軟體支援，請按 2。」) 或者，來電可能會被放在佇列中並保留來電者，直到專員可接聽來電。專員是否可接聽電話的狀態，也是由工作流程指定的：工作流程可用來設定營業時間 (一星期的哪幾天和哪些時段會有專員接聽電話) 與假日 (哪幾天沒有專員可接聽電話)。
使用 New-CsRgsWorkflow 指令程式可建立新的工作流程。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsRgsWorkflow Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsWorkflow"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Name |
必要 |
字串 |
指派給工作流程的唯一名稱。Parent 屬性和 Name 屬性的組合可讓您單獨識別工作流程，而不必參考工作流程的全域唯一識別碼 (GUID)。 |
Parent |
必要 |
Rgs 識別 |
主控新工作流程的服務。例如：-Parent "service:ApplicationServer:atl-cs-001.litwareinc.com"。 |
PrimaryUri |
必要 |
SIP 位址 |
工作流程的 SIP 位址。例如：-PrimaryUri "sip:helpdesk@litwareinc.com"。PrimaryUri 的開頭必須是 "sip"：首碼。 |
Active |
選用 |
布林值 |
如果設為 True 時，表示工作流程為使用中，可以接聽電話。如果設為 False (預設值)，工作流程便無法接聽電話。 Active 屬性設為 True 時，系統則會先驗證工作流程再建立之。例如，若未指定 DefaultAction，則不會建立工作流程。如果 Active 設為 False (或未設定)，則不會進行驗證，即使未指定 DefaultAction，仍會建立工作流程。 |
Anonymous |
選用 |
布林值 |
如果設為 True，則任何時候當各個回應群組專員在接聽電話時，這些專員的識別會加上遮罩。如果設為 False (預設值)，則來電者可看見專員的識別。 |
BusinessHoursID |
選用 |
BusinessHours 物件 |
工作流程專員一星期有哪幾天和哪些時段可接聽來電。使用 Get-CsRgsHoursOfBusiness 指令程式可以擷取營業時間 Identities。 |
CustomMusicOnHoldFile |
選用 |
AudioFile 物件 |
表示當來電者等候接聽時播放的自訂音樂(如果未定義，來電者在等候接聽時會聽到預設的音樂)。自訂音樂必須使用 Import-CsRgsAudioFile 指令程式匯入。 |
DefaultAction |
必要 |
CallAction 物件 |
表示於營業時間開啟工作流程時要採取的動作。必須使用 New-CsRgsCallAction 指令程式定義 DefaultAction，而且必須將通話引導至佇列或問題。如果工作流程為使用中，則 DefaultAction 為必要項目，但如果未使用工作流程，則可以省略此參數。 |
Description |
選用 |
字串 |
可讓系統管理員新增有關回應群組工作流程的額外資訊。例如，描述可包括工作流程擁有者的連絡人資訊。此描述出現在工作流程的 Microsoft Lync 2010 連絡人卡片中。 |
DisplayNumber |
選用 |
字串 |
在 Lync 2010 中顯示的工作流程電話號碼。DisplayNumber 可設定成任何您想要的格式，例如： -DisplayNumber "555-1219" -DisplayNumber "1-(425)-555-1219" -DisplayNumber "1.425.555.1219" |
EnabledForFederation |
選用 |
布林值 |
表示工作流程是否可供同盟網域的使用者使用。如果設為 False，則只有您組織中的使用者能夠存取工作流程。 |
HolidayAction |
選用 |
CallAction 物件 |
如果在假日接到電話時要採取的動作。HolidayAction 必須使用 New-CsRgsCallAction 指令程式定義。 |
HolidaySetIdList |
選用 |
HolidaySet 物件 |
表示哪幾天工作流程專員不會接聽來電。使用 Get-CsRgsHolidaySet 指令程式可以擷取假日集 Identities。 |
Language |
選用 |
字串 |
用於讀取工作流程文字轉換語音提示的語言。只要作業系統使用下方清單列出的支援語言，語言參數則為選用項目 (請注意，支援的語音語言代表作業系統上可以使用的語言子集)。 如果作業系統並非使用支援的語言，則 Language 參數會變成必要項目，且該參數必須指定支援語言的語言代碼。如果您的作業系統使用不支援的語言，而且您執行 New-CsRgsWorkflow 且不包含 Language 參數，則您的命令會失敗。 例如，假設您的作業系統以法羅群島語執行。Windows 作業系統支援此語言，但回應群組應用程式不支援此語言。因此，當您建立新的工作流程時，必須包含 Language 參數及支援的語言。 這是必要步驟，因為，如果未指定語言，工作流程會使用作業系統的語言。但是，只有回應群組應用程式支援該語言時，您才能在工作流程中使用該語言。 語言必須使用下列其中一個語言代碼指定： ca-Es – 卡達隆尼亞文 (西班牙) da-DK – 丹麥文 (丹麥) de-DE – 德文 (德國) en-AU – 英文 (澳洲) en-CA – 英文 (加拿大) en-GB – 英文 (英國) en-IN – English (India) en-US – 英文 (美國) es-ES – 西班牙文 (西班牙) es-MX – 西班牙文 (墨西哥) fi-FI – 芬蘭文 (芬蘭) fr-CA – 法文 (加拿大) fr-FR – 法文 (法國) it-IT – 義大利文 (義大利) ja-JP – 日文 (日本) ko-KR – 韓文 (韓國) nb-NO – 挪威文，巴克摩 (挪威) nl-NL – 荷蘭文 (荷蘭) pl-PL – 波蘭文 (波蘭) pt-BR – 葡萄牙文 (巴西) pt-PT – 葡萄牙文 (葡萄牙) ru-RU – 俄文 (俄羅斯) sv-SE – 瑞典文 (瑞典) zh-CN – 中文 (中華人民共和國) zh-HK – 中文 (香港特別行政區) zh-TW – 中文 (台灣) 例如：-Language "nl-NL"。 |
LineUri |
選用 |
字串 |
工作流程的電話號碼。必須使用下列格式指定電話線路統一資源識別項 (URI)：在 TEL:首碼後面加上加號，後面再加上國碼/地區碼、區碼與電話號碼 (只能使用數字：不能有空格、句點或連字號)。例如：-LineUri "TEL:+14255551219" |
NonBusinessHoursAction |
選用 |
CallAction 物件 |
如果在工作流程指定的營業時間之外接到來電時，應採取的動作。NonBusinessHoursAction 必須使用 New-CsRgsCallAction 指令程式定義。 |
TimeZone |
選用 |
字串 |
用於決定假日與營業時間的時區資訊。例如：-TimeZone "Pacific Standard Time" |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
輸入類型
無。New-CsRgsWorkflow 不會接受管線傳送的資料。
傳回類型
New-CsRgsWorkflow會建立 Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow 物件的新執行個體。
範例
-------------------------- 範例 1 ------------------------
New-CsRgsWorkflow -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -PrimaryUri "sip:helpdesk@litwareinc.com"
上述命令會在 ApplicationServer:atl-cs-001.litwareinc.com 服務上建立新的工作流程。系統會將 Help Desk 這個名稱給予這個工作流程，並指派給此工作流程 sip:helpdesk@litwareinc.com 這個主要 URI。
-------------------------- 範例 2 ------------------------新增程式碼範例
$prompt = New-CsRgsPrompt -TextToSpeechPrompt "Welcome to the help desk."
$queue = (Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk").Identity
$callAction = New-CsRgsCallAction -Prompt $prompt -Action TransferToQueue -QueueId $queue
New-CsRgsWorkflow -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -PrimaryUri "sip:helpdesk@litwareinc.com" -DefaultAction $callAction
範例 2 所示的命令會建立新的工作流程提示與來電動作，並將這些新項目指派給新的回應群組工作流程。在第一個命令中，New-CsRgsPrompt 指令程式是用來建立文字轉換語音提示「Welcome to the help desk」。這個新的提示會儲存在名為 $prompt 的變數中。
第二個命令會使用 Get-CsRgsQueue 指令程式擷取名為 Help Desk 的現有回應群組佇列識別，傳回的識別會儲存在名為 $queue 的變數中。
命令 3 接著會建立新的來電動作 (儲存在名為 $callAction 的變數中)，此動作會參照新的提示 ($prompt) 與擷取的佇列 ($queue)。最後，範例中的最後一個命令會建立名稱為 Help Desk 的新工作流程。此命令會將 PrimaryUri 設為 sip:helpdesk@litwareinc.com，並將 DefaultAction 屬性的值設為在前幾個步驟中建立的來電動作。