New-CsCpsConfiguration
上一次修改主题： 2012-03-23
创建新的呼叫驻留服务设置集合。呼叫驻留是一项允许用户驻留来电的服务。驻留呼叫会将呼叫转接至指定范围内的号码或通道，并立即将其置于呼叫等待状态。任何人（不只是最初接听电话的人员）都可以通过输入正确的号码，来从任何电话恢复对话。
语法
New-CsCpsConfiguration -Identity <XdsIdentity> [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]
详细说明
此 cmdlet 用于创建新的呼叫驻留服务配置。安装呼叫驻留服务后，默认情况下将配置全局设置，且这些设置只能更新而不能删除。（“删除”全局设置只会将它们重置为默认值。）因此，此 cmdlet 仅用于创建特定于站点的设置。
呼叫驻留服务配置指定呼叫驻留后的事项。例如，如果驻留呼叫在一段时间后仍然无人接听，则会将该呼叫自动转接到其他人，如管理员或响应组。可以将呼叫配置为在一段时间后响铃，以确保不会将其遗忘。此外，可以将呼叫驻留服务配置为在呼叫驻留时为呼叫者播放呼叫等待音乐。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsCpsConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsCpsConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
应用设置的站点。必须以 site:<sitename> 格式输入该内容，例如 site:Redmond。配置将始终在 global 作用域存在且无法删除，因此不能使用此 cmdlet 重新创建全局配置。 |
CallPickupTimeoutThreshold |
可选 |
TimeSpan |
呼叫驻留后到回拨此前应答呼叫的电话之前等待的时间。 必须以 hh:mm:ss（hh = 小时，mm = 分钟，ss = 秒）格式输入此时间 默认值：00:01:30（90 秒），最小值：10 秒 (00:00:10)；最大值：10 分钟 (00:10:00) |
EnableMusicOnHold |
可选 |
布尔值 |
决定驻留呼叫时是否向呼叫者播放音乐。 Microsoft Lync Server 2010 附带一个默认的呼叫等待音乐文件。可以使用 Set-CsCallParkServiceMusicOnHoldFile cmdlet 更改此文件（从而更改呼叫驻留时呼叫者听到的音乐）。 默认值：True |
MaxCallPickupAttempts |
可选 |
Int32 |
在放弃并将驻留呼叫转接到回退统一资源标识符 (URI) 之前该驻留呼叫回拨应答电话的次数。通过 OnTimeoutURI 参数设置回退 URI。 默认值：1；最小值：1；最大值：10 |
OnTimeoutURI |
可选 |
字符串 |
无应答的驻留呼叫将路由到的用户或响应组的 SIP 地址。在尝试了由 MaxCallPickupAttempts 参数定义的回拨次数之后，将对该驻留呼叫进行路由。如果将该参数设置为 Null，将忽略 OnTimeoutURI，并且尝试回拨失败后，驻留呼叫将断开连接。 值必须为以字符串 sip: 开头的 SIP URI。例如，sip:rgs1@litwareinc.com。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
InMemory |
可选 |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
此 cmdlet 创建一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings 的对象。
示例
-------------------------- 示例 1 --------------------------
New-CsCpsConfiguration -Identity site:Redmond1 -EnableMusicOnHold $False
示例 1 中显示的命令使用 New-CsCpsConfiguration cmdlet 为站点 Redmond1 创建呼叫驻留服务配置。将使用默认值创建此配置，但 EnableMusicOnHold 例外。该命令将此属性设置为 False，这意味着呼叫已驻留的呼叫者不会在呼叫等待期间听到任何内容。（默认情况下，EnableMusicOnHold 设置为 True，假定已部署呼叫驻留服务。）
-------------------------- 示例 2 --------------------------
New-CsCpsConfiguration -Identity site:Redmond1 -OnTimeoutURI sip:kenmyer@litwareinc.com
示例 2 中显示的命令使用 New-CsCpsConfiguration cmdlet 为站点 Redmond1 创建呼叫驻留服务配置。默认情况下不会提供 OnTimeoutURI，因此此示例为该参数添加一个值。在此示例中，OnTimeoutURI 设置为 sip:kenmyer@litwareinc.com。传递给该参数的值必须以字符串“sip:”开头，并且应该指向将接收未在指定回拨尝试次数之后接听的驻留呼叫的用户或响应组。
-------------------------- 示例 3 --------------------------
New-CsCpsConfiguration -Identity site:Redmond1 -MaxCallPickupAttempts 2
此命令使用 New-CsCpsConfiguration cmdlet 为站点 Redmond1 创建呼叫驻留服务配置。对于此站点，MaxCallPickupAttempts 已设置为 2，这意味着呼叫最多将回拨两次。