Get-CsCpsConfiguration
上一次修改主题： 2012-03-23
返回有关呼叫驻留服务的信息。呼叫驻留是一项允许用户驻留来电的服务。驻留某个呼叫会将该呼叫转接到指定范围或通道中的一个号码，然后立即将它置于保持状态。任何人（不只是最初接听电话的人员）都可以通过输入正确的号码，来从系统中的任何电话恢复对话。
语法
Get-CsCpsConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsCpsConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
此 cmdlet 用于检索一个或多个呼叫驻留服务配置。呼叫驻留服务配置指定呼叫驻留后的事项。例如，如果驻留呼叫在一段时间后仍然无人接听，则会将该呼叫自动转接到其他人，如管理员或响应组。还可以将呼叫配置为在一段时间后响铃，以确保不会将其遗忘。此外，可以将呼叫驻留服务配置为在呼叫驻留时为呼叫者播放呼叫等待音乐。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsCpsConfiguration cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsCpsConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要检索的呼叫驻留服务配置的唯一标识符。此标识符将为 Global 或 site:<sitename>，其中 <sitename> 是应用该配置的站点的名称。 |
Filter |
可选 |
字符串 |
允许执行通配符搜索以便仅检索标识值与通配符字符串匹配的配置。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而不是从中央管理存储本身检索呼叫驻留服务信息。 |
输入类型
无。
返回类型
检索一个或多个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings 的对象。
示例
-------------------------- 示例 1 --------------------------
Get-CsCpsConfiguration
示例 1 检索所有定义为在组织中使用的呼叫驻留服务配置的集合。
-------------------------- 示例 2 --------------------------
Get-CsCpsConfiguration -Identity site:Redmond1
上述命令仅检索 Identity 为 site:Redmond1 的呼叫驻留服务配置。
-------------------------- 示例 3 --------------------------
Get-CsCpsConfiguration -Filter site:*
在示例 3 中，使用 Filter 参数返回在 site 作用域配置的所有呼叫驻留服务配置。通配符字符串 site:* 通知 Get-CsCpsConfiguration 仅返回标识以字符串值 site: 开头的设置。
-------------------------- 示例 4 --------------------------
Get-CsCpsConfiguration -Filter *:re*
与示例 3 一样，在此示例中，我们也使用 Filter 参数来检索所有定义的呼叫驻留服务配置的子集。在此示例中，按字符串 *:re* 来筛选，这会返回名称以字母“re”开头的所有站点（如 Redmond1、Redmond2 和 RemoteComputer）的呼叫驻留配置。
-------------------------- 示例 5 --------------------------
Get-CsCpsConfiguration | Where-Object {$_.EnableMusicOnHold -eq $False}
上面显示的命令返回在呼叫者置于呼叫等待状态时不播放音乐的所有呼叫驻留服务设置。为执行此操作，该命令首先使用 Get-CsCpsConfiguration 检索配置为在组织中使用的所有呼叫驻留服务设置。然后，将该集合通过管道传递到 Where-Object cmdlet，而后该 cmdlet 会应用筛选器将返回的数据限制为 EnableMusicOnHold 属性等于 (-eq) False 的项。