Set-UMDialplan

 

适用于: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题: 2012-03-26

Set-UMDialplan cmdlet 可以用于为统一消息 (UM) 拨号计划设置各种属性。

语法

Set-UMDialPlan -Identity <UMDialPlanIdParameter> [-AccessTelephoneNumbers <MultiValuedProperty>] [-AllowDialPlanSubscribers <$true | $false>] [-AllowedInCountryOrRegionGroups <MultiValuedProperty>] [-AllowedInternationalGroups <MultiValuedProperty>] [-AllowExtensions <$true | $false>] [-AudioCodec <G711 | Wma | Gsm>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-CallSomeoneEnabled <$true | $false>] [-ConfiguredInCountryOrRegionGroups <MultiValuedProperty>] [-ConfiguredInternationalGroups <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-ContactAddressList <AddressListIdParameter>] [-ContactRecipientContainer <OrganizationalUnitIdParameter>] [-ContactScope <DialPlan | GlobalAddressList | Extension | AutoAttendantLink | AddressList>] [-CountryOrRegionCode <String>] [-DefaultLanguage <UMLanguage>] [-DialByNamePrimary <LastFirst | FirstLast | SMTPAddress>] [-DialByNameSecondary <LastFirst | FirstLast | SMTPAddress | None>] [-DomainController <Fqdn>] [-EquivalenceDialPlan <Guid>] [-Extension <String>] [-FaxEnabled <$true | $false>] [-FDSPollingInterval <Int32>] [-InCountryOrRegionNumberFormat <NumberFormat>] [-InfoAnnouncementEnabled <True | False | Uninteruptible>] [-InfoAnnouncementFilename <String>] [-InputFailuresBeforeDisconnect <Int32>] [-InputRetries <Int32>] [-InputTimeout <Int32>] [-InternationalAccessCode <String>] [-InternationalNumberFormat <NumberFormat>] [-LogonFailuresBeforeDisconnect <Int32>] [-MatchedNameSelectionMethod <Title | Department | Location | None | PromptForAlias>] [-MaxCallDuration <Int32>] [-MaxRecordingDuration <Int32>] [-Name <String>] [-NationalNumberPrefix <String>] [-NDREnabled <$true | $false>] [-OperatorExtension <String>] [-OutsideLineAccessCode <String>] [-PromptPublishingPoint <String>] [-RecordingIdleTimeout <Int32>] [-SendVoiceMsgEnabled <$true | $false>] [-TUIPromptEditingEnabled <$true | $false>] [-UMAutoAttendant <UMAutoAttendantIdParameter>] [-VoIPSecurity <SIPSecured | Unsecured | Secured>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>] [-WhatIf [<SwitchParameter>]]

Set-UMDialPlan [-AccessTelephoneNumbers <MultiValuedProperty>] [-AllowDialPlanSubscribers <$true | $false>] [-AllowedInCountryOrRegionGroups <MultiValuedProperty>] [-AllowedInternationalGroups <MultiValuedProperty>] [-AllowExtensions <$true | $false>] [-AudioCodec <G711 | Wma | Gsm>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-CallSomeoneEnabled <$true | $false>] [-ConfiguredInCountryOrRegionGroups <MultiValuedProperty>] [-ConfiguredInternationalGroups <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-ContactAddressList <AddressListIdParameter>] [-ContactRecipientContainer <OrganizationalUnitIdParameter>] [-ContactScope <DialPlan | GlobalAddressList | Extension | AutoAttendantLink | AddressList>] [-CountryOrRegionCode <String>] [-DefaultLanguage <UMLanguage>] [-DialByNamePrimary <LastFirst | FirstLast | SMTPAddress>] [-DialByNameSecondary <LastFirst | FirstLast | SMTPAddress | None>] [-DomainController <Fqdn>] [-EquivalenceDialPlan <Guid>] [-Extension <String>] [-FaxEnabled <$true | $false>] [-FDSPollingInterval <Int32>] [-InCountryOrRegionNumberFormat <NumberFormat>] [-InfoAnnouncementEnabled <True | False | Uninteruptible>] [-InfoAnnouncementFilename <String>] [-InputFailuresBeforeDisconnect <Int32>] [-InputRetries <Int32>] [-InputTimeout <Int32>] [-Instance <UMDialPlan>] [-InternationalAccessCode <String>] [-InternationalNumberFormat <NumberFormat>] [-LogonFailuresBeforeDisconnect <Int32>] [-MatchedNameSelectionMethod <Title | Department | Location | None | PromptForAlias>] [-MaxCallDuration <Int32>] [-MaxRecordingDuration <Int32>] [-Name <String>] [-NationalNumberPrefix <String>] [-NDREnabled <$true | $false>] [-OperatorExtension <String>] [-OutsideLineAccessCode <String>] [-PromptPublishingPoint <String>] [-RecordingIdleTimeout <Int32>] [-SendVoiceMsgEnabled <$true | $false>] [-TUIPromptEditingEnabled <$true | $false>] [-UMAutoAttendant <UMAutoAttendantIdParameter>] [-VoIPSecurity <SIPSecured | Unsecured | Secured>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>] [-WhatIf [<SwitchParameter>]]

详细说明

Set-UMDialplan cmdlet 可以更改或修改现有 UM 拨号计划的属性。某些 UM 拨号计划属性是必需的,默认情况下会创建这些属性。但是在某些情况下,创建 UM 拨号计划之后,并非所有 UM 拨号计划属性都是可写的。因此,除非删除现有 UM 拨号计划并创建一个新拨号计划,否则,某些属性无法更改。

important要点:
UM 拨号计划对统一消息的运行很重要。应由了解更改 UM 拨号计划的含义的管理员来修改现有 UM 拨号计划。

要运行 Set-UMDialplan cmdlet,必须为您使用的帐户委派 Exchange 组织管理员角色。

有关管理 Microsoft Exchange Server 2007 所需的权限、角色委派以及权利的详细信息,请参阅权限注意事项

参数

参数 必需 类型 说明

Identity

必需

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

此参数指定 UM 拨号计划标识。此参数是 UM 拨号计划的目录对象标识符。此参数用于将邮箱链接到拨号计划并将统一消息服务器链接到拨号计划。

AccessTelephoneNumbers

可选

Microsoft.Exchange.Data.MultiValuedProperty

此参数指定单个有效语音邮件引导号码或有效语音邮件引导号码的列表。为用户启用统一消息时,将向管理员提供此列表。

AllowDialPlanSubscribers

可选

System.Boolean

此参数指定是否允许订阅者拨打解析为同一拨号计划中的订阅者的号码。默认值为 $true

AllowedInCountryOrRegionGroups

可选

Microsoft.Exchange.Data.MultiValuedProperty

此参数指定可拨号的同一个拨号组中的国家/地区内名称列表。允许的国家/地区内组的名称必须与 UM 拨号计划中指定的组名相匹配。

AllowedInternationalGroups

可选

Microsoft.Exchange.Data.MultiValuedProperty

此参数指定允许的国际拨号组名称的列表。国际拨号组名称必须与拨号计划中指定的组名匹配。

AllowExtensions

可选

System.Boolean

此参数指定是否允许呼叫拨号计划分机。默认值为 $false

AudioCodec

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.AudioCodecEnum

此参数指定用于录音的音频编码解码器。WMA 为默认设置。

AutomaticSpeechRecognitionEnabled

可选

System.Boolean

此参数指定是否为作为拨号计划成员的用户启用语音识别。

CallSomeoneEnabled

可选

System.Boolean

此参数指定是否启用“呼叫某人”功能。

ConfiguredInCountryOrRegionGroups

可选

Microsoft.Exchange.Data.MultiValuedProperty

此参数指定可以使用的国家/地区内组。每个字符串由四个部分组成:

  • 组名(最多 32 个字符)

  • AllowedNumberString

  • DialNumberString

  • TextComment

ConfiguredInternationalGroups

可选

Microsoft.Exchange.Data.MultiValuedProperty

此参数指定可以使用的国际组。每个字符串由四部分组成:

  • 组名(最多 32 个字符)

  • AllowedNumberString

  • DialNumberString

  • TextComment

Confirm

可选

System.Management.Automation.SwitchParameter

此参数将导致命令暂停处理,并且需要管理员在继续处理之前确认该命令将执行的操作。默认值为 $true。

ContactAddressList

可选

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

此参数指定地址列表的标识。如果将 ContactScope 参数设置为 AddressList,则将定义目录搜索的作用域。

ContactRecipientContainer

可选

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

此参数是要用于目录搜索的容器的名称或标识。

ContactScope

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.CallSomeoneScopeEnum

此参数指定在呼叫者访问 UM 拨号计划并指定用户名时,将为其提供的目录搜索的作用域。

CountryOrRegionCode

可选

System.String

此参数指定给定国家或地区的国家或地区代码。这是向特定国家或地区拨号所用的号码。例如,在美国拨打 1。

DefaultLanguage

可选

Microsoft.Exchange.Data.UMLanguage

此参数指定系统的默认语言。从可用语言列表中选择此默认语言。默认为“美国英语”。

DialByNamePrimary

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.DialByNamePrimaryEnum

此参数指定将从指定的源创建“按名称拨号”查找关键字。默认为姓、名。

DialByNameSecondary

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.DialByNameSecondaryEnum

此参数指定将从指定的源创建辅助“按名称拨号”查找关键字。默认为简单邮件传输协议 (SMTP)。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

此参数指定将此配置更改写入 Active Directory 目录服务的域控制器的完全限定的域名。

EquivalenceDialPlan

可选

System.Guid

此参数指定另一个林中的等效拨号计划的名称。电话拨号计划跨越两个林以及创建第二个拨号计划对象时,原始拨号计划中的 GUID 将复制到另一个林中的用户代理地址。

Extension

可选

System.String

此参数指定“呼叫某人”功能在转接呼叫时使用的分机号。

FaxEnabled

可选

System.Boolean

此参数指定系统是否支持传真。如果拨号计划不支持传真,则统一消息服务器将不加载传真组件。默认值为 $true

FDSPollingInterval

可选

System.Int32

检查文件分发服务在发布点提供的新内容的时间间隔(分钟)。范围在 1 分钟到 1,440 分钟之间。默认值为 5 分钟。

InCountryOrRegionNumberFormat

可选

Microsoft.Exchange.Data.NumberFormat

此参数指定要使用的前缀字符串以及要从目录中获取的位数。从同一国家或地区代码内拨入此拨号计划时使用此位数。

InfoAnnouncementEnabled

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.InfoAnnouncementEnabledEnum

此参数指定是否启用信息通知。此参数可以设置为“启用”、“禁用”或“不间断”。默认值为 $true

InfoAnnouncementFilename

可选

System.String

此参数指定信息通知的音频文件名。

InputFailuresBeforeDisconnect

可选

System.Int32

此参数指定在断开呼叫之前允许用户连续输入错误的次数。默认值为 3。

InputRetries

可选

System.Int32

此参数指定在系统超时前呼叫者可以重新输入的次数。此参数适用于经过身份验证的用户以及呼叫应答用户或自动助理用户。默认值为 3。

InputTimeout

可选

System.Int32

此参数指定系统等待用户输入的时间长度。此时间限制适用于经过身份验证的用户以及呼叫应答用户或自动助理用户。默认为 5 秒。

Instance

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMDialPlan

此参数指定代表新拨号计划对象的输入参数。

InternationalAccessCode

可选

System.String

此参数指定拨打国际电话时在电话号码前面追加的代码。例如,拨打 011 呼叫美国。

InternationalNumberFormat

可选

Microsoft.Exchange.Data.NumberFormat

此参数指定在从不同的国家/地区代码拨入此拨号计划时,要使用的前缀字符串以及要从目录中获取的位数。

LogonFailuresBeforeDisconnect

可选

System.Int32

此参数指定在断开呼叫之前允许登录尝试连续失败的次数。默认值为 3。

MatchedNameSelectionMethod

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.DisambiguationFieldEnum

此参数指定用于区分名称与按键输入或语音输入匹配用户的选项。此设置可以设置为下列选项:

  • 部门

  • 职务

  • 位置

  • 提示输入别名

  • 从 UM 拨号计划继承

MaxCallDuration

可选

System.Int32

此参数指定在中断通话并挂断电话之前,通话可以持续的最长时间。默认值为 30 分钟。

MaxRecordingDuration

可选

System.Int32

此参数指定可以录制的邮件的最长时间。包括所有类型的呼叫。可以将此值设置为介于 5 到 100 之间。此值设置太低可能会使较长的语音邮件在完成之前断开连接。此值设置得太高将使用户在收件箱中保存过长的语音邮件。

对于 Exchange 2007 Service Pack 2 (SP2),此设置的值可以介于 1 到 100 之间。

Name

可选

System.String

此参数指定 UM 拨号计划要使用的显示名称。此名称限于 64 个字符。

NationalNumberPrefix

可选

System.String

此参数指定拨打区域外、国家/地区内电话时在电话号码前面追加的代码。例如,在北美洲拨打 1。

NDREnabled

可选

System.Boolean

此参数指定提交的 UM 呼叫应答邮件是否要求未送达报告 (NDR)。如果此参数设置为 $false,则在提交邮件时不要求 NDR。默认值为 $false

OperatorExtension

可选

System.String

此参数指定话务员的分机号。如果未指定此参数,则无法使用“不允许转接到接线员”功能。

OutsideLineAccessCode

可选

System.String

此参数指定预追加到电话号码以拨打外部国家/地区内电话号码的代码。此代码也称为中继代码。默认为 9。

PromptPublishingPoint

可选

System.String

此参数指定自定义提示要驻留服务器的和共享的 Microsoft Windows 文件共享路径。默认路径在添加到 UM 拨号计划后将被设为第一个统一消息服务器。

RecordingIdleTimeout

可选

System.Int32

此参数指定在结束录音之前,呼叫者在录制语音邮件时可以保持沉默的时间长度。默认为 5 秒。

SendVoiceMsgEnabled

可选

System.Boolean

此参数指定是否启用“发送邮件”功能。

TUIPromptEditingEnabled

可选

System.Boolean

此参数指定是否允许获得授权的用户使用电话用户界面 (TUI) 来录制 UM 拨号计划或自动助理提示。默认设置是 $false

UMAutoAttendant

可选

Microsoft.Exchange.Configuration.Tasks.UMAutoAttendantIdParameter

此参数指定呼叫者按星号键 (*) 时执行的自动助理。如果指定了此参数,则将覆盖“呼叫某人”功能。

VoIPSecurity

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMVoIPSecurityType

此参数指定 IP 语音 (VoIP) 通信是未加密还是通过相互传输层安全性 (MTLS) 对信号通道或信号和媒体通道进行加密。默认设置是 UnSecured

WelcomeGreetingEnabled

可选

System.Boolean

此参数指定是否启用自定义欢迎辞。默认值为 $false

WelcomeGreetingFilename

可选

System.String

此参数指定欢迎问候语的音频文件名。

WhatIf

可选

System.Management.Automation.SwitchParameter

此参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数,管理员可以查看要发生的更改,而不必应用任何这些更改。默认值为 $true。

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

第一个示例配置名为 MyUMDialPlan 的 UM 拨号计划使用 9 作为外线访问代码。

第二个示例配置名为 MyUMDialPlan 的 UM 拨号计划使用欢迎问候语。

第三个示例配置名为 MyUMDialPlan 的 UM 拨号计划与拨号规则。

Set-UMDialPlan -Identity MyDialPlan -OutsideLineAccessCode 9

Set-UMDialPlan -Identity MyDialPlan -WelcomeGreetingEnabled $true -WelcomeGreetingFilename welcome.wav

$csv=import-csv "C:\MyInCountryGroups.csv"
Set-UMDialPlan -Identity MyDialPlan -ConfiguredInCountryGroups $csv
Set-UMDialPlan -Identity MyDialPlan -AllowedInCountryGroups "local, long distance"