New-CsRgsPrompt
上一次修改主题： 2012-05-21
创建响应组应用程序的新工作流提示。工作流提示是为呼叫者提供其他信息而播放的音频文件或朗读的文本。
语法
New-CsRgsPrompt [-AudioFilePrompt <AudioFile>] [-TextToSpeechPrompt <String>]
详细说明
响应组工作流的重要作用之一是使呼叫者了解正在执行的操作及其原因。例如，可以将工作流配置为接听电话后立即将呼叫置于等待状态，直到代理可用。这样做没问题，但是还需要通知呼叫者以下事项：1) 已接听电话；2) 呼叫将置于等待状态，直到代理可用。工作流提示的作用就是提供此类信息。
响应组应用程序支持两种不同的工作流提示。首先，可以预先录制然后播放音频文件。要执行此操作，必须以 .WAV 或 .WMA 格式录制提示（“请不要挂断。您的呼叫对我们很重要。”），然后使用 Import-CsRgsAudioFile cmdlet 导入该文件，并将其分配给工作流提示。此外，还可以仅提供要朗读的文本，需要进行提示时，响应组应用程序将使用文本到语音转换功能来“朗读”该文本。文本到语音转换提示更容易配置：不需要录制和导入音频文件。但是，通常音频文件提示的质量和保真度更高。
请注意，文本到语音转换提示中使用的语言与父工作流中使用的语言相同。
New-CsRgsPrompt cmdlet 提供了一种创建工作流提示的方法。每次需要使用提示时都必须重新创建，无法保存和重复使用提示。（这意味着，您还必须重新导入音频文件。）创建新的工作流提示时，必须提供文本到语音转换提示；如果愿意，还可以提供音频文件提示。如果同时提供文本到语音转换提示和音频文件提示，默认情况下，响应组应用程序将使用音频文件，并且仅当音频文件不可用时才会使用文本到语音转换提示。在内存中创建新提示后，通常会将相应的对象引用添加到响应组呼叫操作。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsRgsPrompt cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins 和 RTCUniversalReadOnlyAdmins。但是，由于此 cmdlet 创建一个保存在内存中的对象，并且自身不会对系统进行任何更改，因此实质上任何人都可以运行它。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsPrompt"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
TextToSpeechPrompt |
必需 |
字符串 |
激活工作流时朗读的文本到语音转换 (TTS) 提示。TTS 提示（仅当未指定音频文件时使用）最多可以包含 4096 个字符。 |
AudioFilePrompt |
可选 |
AudioFile 对象 |
激活工作流时播放的音频文件。必须使用 Import-CsRgsAudioFile cmdlet 导入音频文件。 |
输入类型
无。New-CsRgsPrompt 不接受通过管道传递的输入。
返回类型
New-CsRgsPrompt 创建 Microsoft.Rtc.Management.WritableSettings.Prompt 对象的实例。
示例
-------------------------- 示例 1 --------------------------
$queue = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$prompt = New-CsRgsPrompt -TextToSpeechPrompt "Welcome to the help desk. Please hold."
$z = New-CsRgsCallAction -Prompt $prompt -Action TransferToQueue -QueueID $queue.Identity
示例 1 中显示的命令说明了如何在新的呼叫操作中包含工作流提示（和响应组队列）。在第一个命令中，使用 Get-CsRgsQueue cmdlet 返回对响应组队列 Help Desk 的对象引用 ($queue)。在第二个命令中，使用 New-CsRgsPrompt cmdlet 创建新的文本到语音转换提示“Welcome to the help desk. Please hold.”将新提示存储在名为 $prompt 的变量中。
此示例的最后一个命令使用 New-CsRgsCallAction 创建新的响应组呼叫操作 ($z)。创建呼叫操作时，将对象引用 $prompt（包含新创建的工作流提示）用作 Prompt 参数的值；同样，将对象引用 $queue 和 QueueID 参数一起使用。运行此命令后，即可将新的呼叫操作及其新工作流提示添加到响应组工作流。
-------------------------- 示例 2 --------------------------
$queue = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Queue"
$audioFile = Import-CsRgsAudioFile -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -FileName "welcome.wav" -Content (Get-Content C:\Media\Welcome.wav -Encoding byte -ReadCount 0)
$prompt = New-CsRgsPrompt -AudioFilePrompt $audioFile -TextToSpeechPrompt "Welcome to the help desk. Please hold."
$z = New-CsRgsCallAction -Prompt $prompt -Action TransferToQueue -QueueID $queue.Identity
示例 2 中显示的命令是示例 1 中所显示命令的变体。但是在此示例中，新工作流提示同时包含音频文件提示和文本到语音转换提示。为了在工作流提示中包含音频文件，此示例中的第二个命令使用 Import-CsRgsAudioFile cmdlet 导入音频文件 C:\Media\Welcome.wav，然后将导入的文件存储在名为 $audioFile 的变量中。
导入音频文件后，将该文件和文本到语音转换提示添加到新工作流提示 ($prompt) 中。为执行此操作，将 AudioFilePrompt 参数设置为 $audioFile，并将 TextToSpeechPrompt 参数设置为文本值“Welcome to the help desk.请不要挂断。”