Set-CsCallParkOrbit
上一次修改主题： 2012-03-26
设置组织内现有呼叫驻留通道范围的属性。
语法
Set-CsCallParkOrbit [-Identity <XdsGlobalRelativeIdentity>] [-NumberRangeStart <String>] [-NumberRangeEnd <String>] [-CallParkService <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsCallParkOrbit [-NumberRangeStart <String>] [-NumberRangeEnd <String>] [-CallParkService <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
详细说明
驻留呼叫是将收到的电话呼叫分配给特定范围内的号码以备稍后检索。呼叫驻留通道即是为此目的而定义的号码集合。通过 Set-CsCallParkOrbit cmdlet 可以更改号码范围和呼叫驻留服务的 ID。新的号码范围在组织内定义的所有呼叫驻留通道中必须具有唯一性。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsCallParkOrbit cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsCallParkOrbit"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
字符串 |
要修改的呼叫驻留通道范围的唯一标识符。如果 Identity 中包含空格，则必须使用双引号将此值括起来。 |
Instance |
可选 |
DisplayCallParkOrbit |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 此对象的类型必须是显示呼叫驻留通道，它可通过调用 Get-CsCallParkOrbit cmdlet 进行检索。 |
CallParkService |
必需 |
字符串 |
用于托管 呼叫寄存应用程序 的应用程序服务的完全限定域名 (FQDN) 或服务 ID。驻留在由 NumberRangeStart 和 NumberRangeEnd 参数指定的范围内的号码的所有呼叫都将路由到此服务器或池。 |
NumberRangeStart |
必需 |
字符串 |
此呼叫驻留通道的范围中的第一个号码。该值必须小于或等于 NumberRangeEnd。该值的长度必须与 NumberRangeEnd 的值相同。 有效值：必须与正则表达式字符串 ([\*|#]?[1-9]\d{0,7})|([1-9]\d{0,8}) 匹配。这意味着该值必须是一个以字符 * 或 # 或者 1 到 9 之间的一个数字开头的字符串（第一个字符不能为零）。如果第一个字符是 * 或 #，则下一个字符必须是 1 到 9 之间的一个数字（不能为零）。随后最多可包含七个其他字符，这些字符可以是 0 到 9 之间的任意数字（例如“#6000”、“*92000”和“*95551212”。）* 或 # 后的数字必须大于 100。如果第一个字符不是 * 或 #，则第一个字符必须是 1 到 9 之间的一个数字（不能为零），后跟最多八个字符，其中每个字符都是介于 0 到 9 之间的数字。（例如，915551212、41212、300。） |
NumberRangeEnd |
必需 |
字符串 |
此呼叫驻留通道的范围中的最后一个号码。该值必须大于或等于 NumberRangeStart。该值的长度必须与 NumberRangeStart 的值相同。例如，如果 NumberRangeStart 设置为 100，则 NumberRangeEnd 不能设置为 1001。此外，如果 NumberRangeStart 以 * 或 # 开头，则 NumberRangeEnd 必须以相同的字符开头。 有效值：必须与正则表达式字符串 ([\*|#]?[1-9]\d{0,7})|([1-9]\d{0,8}) 匹配。这意味着该值必须是一个以字符 * 或 # 或者 1 到 9 之间的一个数字开头的字符串（第一个字符不能为零）。如果第一个字符是 * 或 #，则下一个字符必须是 1 到 9 之间的一个数字（不能为零）。随后最多可包含七个其他字符，这些字符可以是 0 到 9 之间的任意数字（例如“#6000”、“*92000”和“*95551212”。）如果第一个字符不是 * 或 #，则它必须是 1 到 9 之间的数字（不能是零），后跟最多八个字符，其中每个字符都是介于 0 到 9 之间的数字（例如：915551212、41212、300）。 |
Force |
可选 |
开关参数 |
禁止显示任何本该在进行更改前显示的确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.Voice.Helpers.DisplayCallParkOrbit 对象。接受通过管道传递的呼叫驻留通道对象的输入。
返回类型
此 cmdlet 可修改一个类型为 Microsoft.Rtc.Management.Voice.Helpers.DisplayCallParkOrbit 的对象。
示例
-------------------------- 示例 1 --------------------------
Set-CsCallParkOrbit -Identity "Redmond CPO 1" -NumberRangeStart 500 -NumberRangeEnd 699
此示例将名为“Redmond CPO 1”的呼叫驻留通道的号码范围更改为 500 到 699。此范围内的所有值在组织内的所有呼叫驻留通道范围中必须具有唯一性。
-------------------------- 示例 2 --------------------------
Set-CsCallParkOrbit -Identity "Redmond CPO 2" -NumberRangeStart "*7000" -NumberRangeEnd "*7100"
此示例将名为“Redmond CPO 2”的呼叫驻留通道的号码范围更改为 *7000 到 *7100。此范围内的所有值在组织内的所有呼叫驻留通道范围中必须具有唯一性。请注意，与前面的示例不同，分配给 NumberRangeStart 和 NumberRangeEnd 的值用双引号括了起来。如果这些值以 * 或 #（仅有的两个允许使用的非数字值）开头，则必须用双引号将值括起来。