共用方式為


Set-UMDialplan (RTM)

 

適用版本: Exchange Server 2007

上次修改主題的時間: 2012-03-26

Set-UMDialplan 指令程式可以用來設定整合通訊 (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>] [-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>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>]

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>] [-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>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>]

詳細描述

Set-UMDialplan 指令程式可讓您變更或修改現有 UM 撥號對應表的內容。某些 UM 撥號對應表內容是必要的,因此預設已建立。不過,在某些情況下,建立 UM 撥號對應表之後,並非所有 UM 撥號對應表內容均為可寫入的內容。因此,除非刪除現有 UM 撥號對應表,並建立新的 UM 撥號對應表,否則無法變更某些內容。

important重要事項:
UM 撥號對應表是整合通訊作業的重要部分。現有 UM 撥號對應表的修改應該由了解 UM 撥號對應表變更之含義的系統管理員執行。

若要執行 Set-UMDialplan 指令程式,必須對您使用的帳戶委派下列項目:

  • Exchange 組織系統管理員角色

如需管理 Exchange Server 2007 所需之權限、委派角色及權利的相關資訊,請參閱權限考量

參數

參數 必要 類型 描述

Identity

必要

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

此參數指定 UM 撥號對應表識別碼。此參數是 UM 撥號對應表的目錄物件識別碼。此參數是用來將信箱連結至撥號對應表,以及將 Unified Messaging Server 連結至撥號對應表。

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

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 目錄服務之網域控制站的網域全名,請在指令程式中加入 DomainController 參數。

EquivalenceDialPlan

選用

System.Guid

此參數指定另一個樹系中之對等撥號對應表的名稱。電話語音撥號對應表跨越兩個樹系時,以及建立第二個撥號對應表物件時,會將原始撥號對應表中的 GUID 複製至使用者在另一個樹系中的 Proxy 位址。

Extension

選用

System.String

此參數指定在轉接電話時,[呼叫某人] 功能所用的分機號碼。

FaxEnabled

選用

System.Boolean

此參數指定系統是否支援傳真。如果撥號對應表不支援傳真,Unified Messaging Server 就不會載入傳真元件。預設是 $true

FDSPollingInterval

選用

System.Int32

在發行端點上檢查檔案發佈服務是否有產生新內容的間隔 (分鐘)。範圍是介於 1 至 1440 分鐘之間。預設為 5 分鐘。

InCountryOrRegionNumberFormat

選用

Microsoft.Exchange.Data.NumberFormat

此參數指定要使用的首碼字串,以及要從目錄中取用的位數。從相同國碼或區碼內撥打此撥號對應表時,會使用此號碼。

InfoAnnouncementEnabled

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.InfoAnnouncementEnabledEnum

此參數指定是否啟用語音總機。此參數可設為 Enabled、Disabled 或 Uninterruptible。預設是 $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 Server 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

此參數指定自訂提示所在之伺服器 Windows 檔案共用的以及共用。預設路徑設為新增至 UM 撥號對應表的第一部 Unified Messaging Server。

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

這個參數可指定訊號通道是否透過使用 MTLS 加密。預設值是 UnSecured

WelcomeGreetingEnabled

選用

System.Boolean

此參數指定是否啟用自訂歡迎使用問候語。預設是 $false

WelcomeGreetingFilename

選用

System.String

此參數指定歡迎使用問候語的音訊檔案名稱。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

第一個範例設定名為 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"