Get-CsCallParkOrbit
上一次修改主题： 2012-03-23
获取组织的呼叫驻留通道范围设置。
语法
Get-CsCallParkOrbit [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsCallParkOrbit [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
此 cmdlet 检索为组织定义的呼叫驻留通道的设置。您可以检索单个呼叫驻留通道范围（由 Identity 参数指定）或者调用不带任何参数的 Get-CsCallParkOrbit 来检索为组织定义的所有呼叫驻留通道范围。呼叫驻留通道由一些设置组成，这些设置指定了用户可以驻留呼叫的号码范围，以及与这些号码范围相关联的服务器。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsCallParkOrbit cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins 和 RTCUniversalReadOnlyAdmin。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsCallParkOrbit"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
字符串 |
呼叫驻留通道范围的唯一名称。该名称由管理员在定义呼叫驻留通道范围时指定。 |
Filter |
可选 |
字符串 |
此参数接受通配符字符串，并返回标识与该字符串匹配的所有呼叫驻留通道范围。例如，如果 Filter 值为 Redmond*，则将返回名称以字符串“Redmond”开头的所有呼叫驻留通道范围，如 Redmond 1、Redmond 2 和 RedmondCPO 等。 |
LocalStore |
可选 |
全局唯一标识符 |
从中央管理存储的本地副本，而非中央管理存储本身检索呼叫驻留通道信息。 |
输入类型
无。
返回类型
此 cmdlet 可返回一个类型为 Microsoft.Rtc.Management.Voice.Helpers.DisplayCallParkOrbits 的对象。
示例
-------------------------- 示例 1 --------------------------
Get-CsCallParkOrbit
在此示例中，调用了 Get-CsCallParkOrbit，而未指定任何其他参数。这样调用时，Get-CsCallParkOrbit 返回配置为在组织中使用的所有呼叫驻留通道范围的集合。
-------------------------- 示例 2 --------------------------
Get-CsCallParkOrbit -Identity "Redmond CPO 1"
在上述示例中，Get-CsCallParkOrbit 用于返回有关名称为“Redmond CPO 1”的呼叫驻留通道范围的信息。
-------------------------- 示例 3 --------------------------
Get-CsCallParkOrbit -Filter *Redmond*
此示例中的命令返回 Identity 中包含字符串“Redmond”的所有呼叫驻留通道范围。例如，此命令将返回标识为“Redmond 501”、“CP Redmond 1”和“ARedmond”等的呼叫驻留通道。此命令使用带有通配符 (*) 的 Filter 参数来指定要搜索的内容。（该搜索不区分大小写。）
-------------------------- 示例 4 --------------------------
Get-CsCallParkOrbit | Where-Object {$_.CallParkServiceId.toString() -eq "ApplicationServer:pool0.litwareinc.com"}
此命令返回分配给 ID 为 ApplicationServer:pool0.litwareinc.com 的呼叫驻留服务的所有呼叫驻留通道范围。Get-CsCallParkOrbit cmdlet 检索所有呼叫驻留通道范围的集合，然后将此集合通过管道传递到 Where-Object cmdlet。此处对 Where-Object 的调用将找出此集合中 CallParkServiceId 属性的值为 ApplicationServer:pool0.litwareinc.com 的所有呼叫驻留通道。请注意，在 CallParkServiceId 参数名称的末尾添加了 toString 方法。CallParkServiceId 的类型为 WritableServiceId。为了将该值与提供的字符串进行比较，首先必须调用 toString 方法将该值转换为字符串。
-------------------------- 示例 5 --------------------------
Get-CsCallParkOrbit | Where-Object {$_.NumberRangeStart.StartsWith("*")}
此示例中的命令返回号码范围以 * 前缀开头的所有呼叫驻留通道范围。Get-CsCallParkOrbit 检索到所有呼叫驻留通道范围的集合后，将此集合通过管道传递到 Where-Object。Where-Object 将集合限制为仅呼叫驻留位置以 * 开头的呼叫驻留通道范围。它通过在 NumberRangeStart 对象的 StartsWith 属性中检查字符串“*”来实现该操作。
-------------------------- 示例 6 --------------------------
Get-CsCallParkOrbit | Where-Object {[Char]::IsDigit($_.NumberRangeStart[0])}
此示例中的命令返回没有为范围中的号码分配前缀的所有呼叫驻留通道范围。（前缀是放置在号码开头的值 * 或 #。）此命令返回的所有呼叫驻留通道的范围将仅由数字构成，而不包含其他任何字符。Get-CsCallParkOrbit 检索所有呼叫驻留通道范围的集合，然后将此集合通过管道传递到 Where-Object。查看 Where-Object 的调用中的条件时，我们将看到以下内容：($_.NumberRangeStart[0])。这将返回位于范围开头的号码中的第一个字符。（请注意，我们只需检查范围的开头，如果范围开头的号码没有前缀，则末尾的号码也不会有前缀。）此字符将传递给 IsDigit 函数，以确定其是否为数字字符。如果是，将返回对应集合项的呼叫驻留通道信息。