New-CsDialPlan
上一次修改主题: 2012-03-27
创建新的拨号计划。
语法
New-CsDialPlan -Identity <XdsIdentity> [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
详细说明
此 cmdlet 可创建新的拨号计划(也称为位置配置文件)。拨号计划提供了企业语音用户进行电话呼叫时所需的信息。拨号计划也可由 会议助理应用程序 用于实现电话拨入式会议功能。拨号计划可确定要应用哪些规范化规则,以及在进行外部呼叫时是否必须拨打前缀号码等内容。
自动创建拨号计划会创建默认的语音规范化规则。可通过调用 Set-CsVoiceNormalizationRule cmdlet 修改规范化规则。通过调用 New-CsVoiceNormalizationRule cmdlet 可将新的规范化规则添加到拨号计划中。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 New-CsDialPlan cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsDialPlan"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
Xds 标识 |
用于指定作用域和名称 (site)、服务角色和 FQDN 或名称(每用户)来标识拨号计划的唯一标识符。例如,可以按照“site:<sitename>”的格式输入站点 Identity,其中 sitename 是该站点的名称。Service 作用域的拨号计划必须为 Registrar 或 PSTN 网关服务,其中 Identity 值的格式如下:Registrar:Redmond.litwareinc.com。对于每用户 Identity,只需将其作为唯一的字符串值输入即可。 |
Description |
可选 |
字符串 |
对该拨号计划的描述,包括拨号计划的用途、适用于什么类型的用户,或其他任何有助于确定拨号计划用途的信息。 最大字符数:512 |
DialinConferencingRegion |
可选 |
字符串 |
与此拨号计划关联的地区的名称。如果拨号计划将用于电话拨入式会议,则为此参数指定值。这样可以在会议组织者设置会议时分配正确的访问号码。可以通过调用 Get-CsNetworkRegion cmdlet 来检索可用的区域。 最大字符数:512 |
ExternalAccessPrefix |
可选 |
字符串 |
一个(或一组)用于将呼叫指定为组织外部呼叫的号码。(例如,要拨打外线,请首先按 9。)规范化规则将忽略此前缀号码,但会应用于其余的号码。 OptimizeDeviceDialing 参数必须设置为 True,该值才能生效。 此参数必须匹配正则表达式 [0-9]{1,4}。这意味着它必须是一个 0 到 9 之间的值,长度为 1 至 4 位。 默认值:9 |
NormalizationRules |
可选 |
PSListModifier |
应用于该拨号计划的规范化规则的列表。 虽然可以通过此 cmdlet 直接创建该列表以及这些规则,但是建议您使用 New-CsVoiceNormalizationRule cmdlet 创建规范化规则,该 cmdlet 会创建规则并将其分配给指定的拨号计划。 每次创建一个新拨号计划时,还会为该站点、服务或每用户拨号计划创建一个使用默认设置的新语音规范化规则。默认情况下,新语音规范化规则的 Identity 是拨号计划 Identity 后跟一个斜线,再后跟名称 Prefix All。例如,site:Redmond/Prefix All。 默认值:{Description=;Pattern=^(\d11)$;Translation=+$1;Name=Prefix All;IsInternalExtension=False } 注意:此默认值只是一个占位符。要使该拨号计划可用,您应修改该拨号计划所创建的规范化规则,或者为站点、服务或用户创建一个新规则。您可以通过调用 New-CsVoiceNormalizationRule cmdlet 创建一个新规范化规则,通过调用 Set-CsVoiceNormalizationRule 修改规范化规则。 |
OptimizeDeviceDialing |
可选 |
布尔值 |
如果此参数设置为 True,则可以将 ExternalAccessPrefix 参数中的前缀应用到在组织外部进行的呼叫。仅当已为 ExternalAccessPrefix 参数指定值时,才能将此值设置为 True。 默认值:False |
SimpleName |
可选 |
字符串 |
拨号计划的显示名称。此名称必须在 Lync Server 部署中的所有拨号计划中具有唯一性。 此字符串最长为 256 个字符。有效的字符包括字母或数字字符、连字符 (-)、点 (.)、加号 (+)、下划线 (_) 和括号 (())。 此参数必须包含值。但是,如果在调用 New-CsDialPlan 时不提供值,则将提供默认值。全局拨号计划的默认值是 Prefix All。站点级别拨号计划的默认值是该站点的名称。服务的默认值是该服务的名称(Registrar 或 PSTN 网关),后跟一个下划线,再后跟该服务的完全限定域名 (FQDN)。例如,Registrar_pool0.litwareinc.com。每用户拨号计划的默认值是该拨号计划的 Identity。 |
State |
可选 |
字符串 |
此参数不用于该 cmdlet。 |
City |
可选 |
字符串 |
此参数不用于该 cmdlet。 |
CountryCode |
可选 |
字符串 |
此参数不用于该 cmdlet。 |
Force |
可选 |
开关参数 |
在进行更改之前取消任何确认提示。 |
InMemory |
可选 |
开关参数 |
创建对象引用,但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量,您可以更改对象引用的属性,然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
此 cmdlet 创建一个类型为 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile 的对象。
示例
-------------------------- 示例 1 --------------------------
New-CsDialPlan -Identity RedmondDialPlan
示例 1 中显示的命令创建一个 Identity 为 RedmondDialPlan 的新拨号计划。(Identity 值中不包含作用域,表明这是一个每用户策略。可以将在每用户作用域创建的拨号计划直接分配给用户和组。)将为拨号计划的其他所有属性分配默认值。
-------------------------- 示例 2 --------------------------
New-CsDialPlan -Identity site:Redmond -SimpleName RedmondSiteDialPlan
New-CsVoiceNormalizationRule -Identity "site:Redmond/SeattlePrefix" -Pattern "^9(\d*){1,5}$" -Translation "+1206$1"
示例 2 中显示的命令创建一个 Identity 为 site:Redmond 的新拨号计划(表示该拨号计划适用于 Redmond 站点上尚未分配有每用户或服务级拨号计划的所有用户)以及 SimpleName RedmondSiteDialPlan。然后,示例中的下一行创建一个与该计划关联的新规范化规则。将为拨号计划创建一个默认规范化规则,但多数情况下该规则创建为一个占位符,这些值的用途很有限。因此在调用 New-CsDialPlan cmdlet 以创建新拨号计划之后,应调用 New-CsVoiceNormalizationRule 以创建对您的组织有效的命名规则。这就是此示例的第 2 行所执行的操作:它调用 New-CsVoiceNormalizationRule 并为 Redmond 站点创建一个名为 SeattlePrefix 的规则,并为该规则指定 Pattern 和 Translation 属性。无需执行其他任何步骤来修改拨号计划;对规范化规则所做的更改将自动应用于标识与规范化规则标识相匹配的拨号计划。(Identity 的 site:Redmond 部分与拨号计划 Identity 匹配;SeattlePrefix 是规范化规则的名称。可以将多个规范化规则应用于一个拨号计划,因此每个规范化规则都需要一个在给定作用域内唯一的名称。)
-------------------------- 示例 3 --------------------------
New-CsDialPlan -Identity RedmondDialPlan -Description "Dial plan for Redmond users"
示例 3 中显示的命令创建一个 Identity 为 RedmondDialPlan 的新拨号计划,并指定用于解释拨号计划用途的 Description 参数。(可以将在每用户作用域创建的拨号计划直接分配给用户和组。)将为其他所有参数分配默认值。