Set-CsDialPlan
上一次修改主题: 2012-03-27
修改现有的拨号计划。
语法
Set-CsDialPlan [-Identity <XdsIdentity>] [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
Set-CsDialPlan [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
详细说明
此 cmdlet 可修改现有的拨号计划(也称为位置配置文件)。拨号计划提供了企业语音用户进行电话呼叫时所需的信息。拨号计划也可由 会议助理应用程序 用于实现电话拨入式会议功能。拨号计划可确定要应用哪些规范化规则,以及在进行外部呼叫时是否必须拨打前缀号码等内容。
注意:虽然可以使用此 cmdlet 修改拨号计划的规范化规则,但是建议改用 New-CsVoiceNormalizationRule、Set-CsVoiceNormalizationRule 或 Remove-CsVoiceNormalizationRule cmdlet 修改这些规则。使用这些 cmdlet 所做的更改会反映在相应拨号计划中。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Set-CsDialPlan cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsDialPlan"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
字符串 |
用于指定作用域(对于每用户计划,则用于指定名称)以标识要修改的拨号计划的唯一标识符。例如,站点 Identity 将采用 site:<sitename> 格式,其中 sitename 是该站点的名称。service 作用域的拨号计划将成为 Registrar 服务或 PSTN 网关服务,其中 Identity 值的格式如下:Registrar:Redmond.litwareinc.com。每用户 Identity 是一个唯一的字符串值。 |
Instance |
可选 |
LocationProfile |
允许您将对对象的引用传递到 cmdlet,而不是设置单个参数值。可通过调用 Get-CsDialPlan cmdlet 来检索此对象引用。 |
Description |
可选 |
字符串 |
对该拨号计划的描述,包括拨号计划的用途、适用于什么类型的用户,或其他任何有助于确定拨号计划用途的信息。 最大字符数:512 |
DialinConferencingRegion |
可选 |
字符串 |
与此拨号计划关联的地区的名称。如果拨号计划将用于电话拨入式会议,则为此参数指定值。这样可以在会议组织者设置会议时分配正确的访问号码。可以通过调用 Get-CsNetworkRegion cmdlet 来检索可用的区域。 最大字符数:512 |
ExternalAccessPrefix |
可选 |
字符串 |
一个(或一组)用于将呼叫指定为组织外部呼叫的号码。(例如,要拨打外线,请首先按 9。)规范化规则将忽略此前缀号码,但会应用于其余的号码。 OptimizeDeviceDialing 参数必须设置为 True,该值才能生效。 此参数的值必须匹配正则表达式 [0-9]{1,4}。这意味着它必须是一个 1 位到 4 位的数值,每位数字为 0 到 9 之间的数字。 |
NormalizationRules |
可选 |
PSListModifier |
应用于该拨号计划的规范化规则的列表。 虽然可以通过此 cmdlet 直接修改该列表以及这些规则,但是建议使用 New-CsVoiceNormalizationRule cmdlet 创建规范化规则(该 cmdlet 会创建规则并将其分配给指定的拨号计划),然后使用 Set-CsVoiceNormalizationRule cmdlet 修改该规则。 |
OptimizeDeviceDialing |
可选 |
布尔值 |
如果此参数设置为 True,则可以将 ExternalAccessPrefix 参数中的前缀应用到在组织外部进行的呼叫。仅当已为 ExternalAccessPrefix 参数指定值时,才能将此值设置为 True。 |
SimpleName |
可选 |
字符串 |
拨号计划的友好名称。拨号计划名称必须在 Microsoft Lync Server 2010 部署中的所有拨号计划之间具有唯一性。 此字符串最长为 256 个字符。有效的字符包括字母或数字字符、连字符 (-)、点 (.)、加号 (+)、下划线 (_) 和括号 (())。 |
State |
可选 |
字符串 |
此参数不用于该 cmdlet。 |
City |
可选 |
字符串 |
此参数不用于该 cmdlet。 |
CountryCode |
可选 |
字符串 |
此参数不用于该 cmdlet。 |
Force |
可选 |
开关参数 |
在进行更改之前取消任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile 对象。接受通过管道传递的拨号计划对象的输入。
返回类型
Set-CsDialPlan 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsDialPlan -Identity RedmondDialPlan -Description "This plan is for Redmond-based users only."
在示例 1 中,Set-CsDialPlan 用于修改 Identity 为 RedmondDialPlan 的拨号计划。在此示例中,唯一要修改的属性是 Description,此修改操作是通过指定 Description 参数并在其后添加新描述文本实现的。
-------------------------- 示例 2 --------------------------
Get-CsDialPlan | Set-CsDialPlan -ExternalAccessPrefix 8
在此示例中,使用 Set-CsDialPlan 更改配置为在组织中使用的所有拨号计划的 ExternalAccessPrefix 属性的值。为此,该命令首先使用 Get-CsDialPlan 返回组织中所有拨号计划的集合。然后,将该集合通过管道传递到 Set-CsDialPlan,后者会为集合中的每个配置文件的 ExternalAccessPrefix 属性分配值 8。