New-CsRgsCallAction
上一次修改主题： 2012-03-23
创建新的响应组呼叫操作。响应组应用程序使用呼叫操作确定收到呼叫时系统所执行的操作。例如，呼叫操作可能会指定将呼叫转接到其他队列，询问特定的响应组问题，或结束该呼叫。
语法
New-CsRgsCallAction -Action <Nullable> [-Prompt <Prompt>] [-Question <Question>] [-QueueID <Nullable>] [-Uri <String>]
详细说明
当有人呼叫与响应组应用程序关联的电话号码时，该应用程序会查找与被叫电话号码对应的工作流。找到工作流后，此服务将检查该呼叫是否在工作时间之外或假日中收到。如果是，则此服务将执行针对工作时间之外或假日中收到的呼叫指定的操作。（例如，该呼叫可能会直接转接到语音邮件。）如果在工作时间收到呼叫，则响应组应用程序将执行针对工作时间收到的呼叫预配置的操作。所有此类操作都是预先确定的，且都是使用 New-CsRgsCallAction cmdlet 创建的。New-CsRgsCallAction 使您可以将呼叫置于响应组队列中，转接到语言邮件、SIP 地址或公用电话交换网 (PSTN) 电话号码，转接到互动语音响应 (IVR) 问题或结束该呼叫。
使用 New-CsRgsCallAction 时，您不会直接修改工作流、队列或其他响应组应用程序元素的属性。您创建的新呼叫操作最初仅存于内存中，且必须存储在对象引用变量（例如 $x）中。当要修改某些内容（例如工作流的 DefaultAction 属性）时，则可将对象引用分配给相应的属性。例如：
-DefaultAction $x
应注意，可分配给 DefaultAction 属性的两个仅有的呼叫操作是 TransferToQueue 和 TransferToQuestion。除 TransferToQueue 和 TransferToQuestion 以外的所有其他呼叫操作对假日或非工作时间发生的操作均有效。此外，除 TransferToQuestion 以外的所有呼叫操作还可用于队列超时和溢出。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsRgsCallAction cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins 和 RTCUniversalReadOnlyAdmins。但是，由于此 cmdlet 创建一个保存在内存中的对象，并且自身不会对系统进行任何更改，因此实质上任何人都可以运行它。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsCallAction"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Action |
必需 |
PS 列表修饰符 |
代表要执行的呼叫操作。必须将 Action 设置为下列值之一： Terminate – 终止呼叫。 TransferToQueue – 将呼叫转接到响应组队列。 TransferToQuestion – 将呼叫转接到响应组问题。 TransferToUri – 将呼叫转接到指定的 SIP 统一资源标识符 (URI)。 TransferToVoiceMailUri – 将呼叫转接到语音邮件。 TransferToPSTN – 将呼叫转接到公用电话交换网 (PSTN) 电话。 每次创建新的呼叫操作时都必须指定 Action，没有默认值。 |
Prompt |
可选 |
提示对象 |
执行呼叫操作之前播放的提示。（例如，“转接电话中，请不要挂断”。）必须使用 New-CsRgsPrompt cmdlet 创建提示。 |
Question |
可选 |
问题对象 |
将 Action 设置为 TransferToQuestion 时要询问的问题。必须使用 New-CsRgsQuestion cmdlet 创建问题。 如果将 Action 设置为 TransferToQuestion，则需要此参数。 |
QueueID |
可选 |
Xds 标识 |
应将呼叫转接到的响应组队列的 Identity（假设已将 Action 设置为 TransferToQueue）。指定 QueueID 的最佳方法是使用 Get-CsRgsQueue 检索相关队列的 Identity。 如果将 Action 设置为 TransferToQueue，则需要此参数。 |
Uri |
可选 |
字符串 |
应将呼叫转接到的 SIP 地址、语言邮件 URI 或 PSTN 电话号码。 如果将 Action 设置为 TransferToUri、TransferToVoiceMailUri 或 TransferToPSTN，则需要此参数。 |
输入类型
无。New-CsRgsCallAction 不接受通过管道传递的输入。
返回类型
New-CsRgsCallAction 创建 Microsoft.Rtc.Rgs.Management.WritableSettings.CallAction 对象的新实例。
示例
-------------------------- 示例 1 --------------------------
$x = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Overflow"
$z = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$w = New-CsRgsPrompt -TextToSpeechPrompt "Please hold while we transfer your call."
$y = New-CsRgsCallAction -Prompt $w -Action TransferToQueue -QueueID $x.Identity
$z.OverflowAction = $y
Set-CsRgsQueue $z
示例 1 中显示的命令演示如何创建一个新的响应组呼叫操作，然后将该操作分配给现有的响应组队列；在此示例中，呼叫操作会确定在达到队列溢出时将会发生的情况。为了执行此任务，第一步是使用 Get-CsRgsQueue 从 ApplicationServer:atl-cs-001.litwareinc.com 检索响应组应用程序队列 Help Desk Overflow；此队列的信息存储在名为 $x 的变量中。然后，使用类似命令检索 Help Desk 队列，并将该信息存储在名为 $z 的变量中。
检索这些队列后，使用 New-CsRgsPrompt cmdlet 创建新呼叫操作附带的文本到语音转换提示。该新呼叫操作是通过运行 New-CsRgsCallAction cmdlet 创建的。向此呼叫操作分配以下三个参数：Prompt（由呼叫操作使用的提示）；Action（用于指示触发新呼叫操作时所执行的操作，参数值 TransferToQueue 表示将呼叫转接到其他响应组队列）；以及 QueueID，即呼叫将转接到的备用队列（$x.Identity，代表队列 Help Desk Overflow 的 Identity）。在内存中创建新呼叫操作，然后将其存储在名为 $y 的变量中。
创建呼叫操作后，您便可以为 Help Desk 队列分配新的呼叫操作；这是通过将 OverflowAction 属性的值设置为 $y 来实现的，其中变量 $y 包含新创建的呼叫操作。如果 Help Desk 队列“溢出”（即达到允许呼叫者的最大数量），任何后续呼叫将会自动转接到 Help Desk Overflow 队列。
最后，示例中的最后一个命令调用 Set-CsRgsQueue 将更改写入 ApplicationServer:atl-cs-001.litwareinc.com 上的 Help Desk Overflow 队列的实际实例。
-------------------------- 示例 2 --------------------------
$w = New-CsRgsPrompt -TextToSpeechPrompt "Please hold while we transfer your call."
$y = New-CsRgsCallAction -Prompt $w -Action TransferToPSTN -Uri "sip:+14255551298@litwareinc.com"
$z = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Queue"
$z.OverflowAction = $y
Set-CsRgsQueue $z
示例 2 中显示的命令与示例 1 中显示的命令类似。但是在示例 2 中，新呼叫操作将呼叫转接到 PSTN 电话号码。为执行此操作，将新呼叫操作的 Action 属性设置为 TransferToPSTN，将 Uri 属性设置为“sip:+14255551298@litwareinc.com”。