Set-UMDialplan

  • [アーティクル]

 

適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

トピックの最終更新日: 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>] [-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 コマンドレットを使用すると、既存の UM ダイヤル プランのプロパティを変更または修正できます。UM ダイヤル プランの一部のプロパティは必須であり、既定で作成されます。ただし、UM ダイヤル プランの一部のプロパティは、UM ダイヤル プランの作成後は書き込み可能でない場合があります。したがって、一部のプロパティについては、プロパティを変更するには既存の UM ダイヤル プランを削除して、新しいダイヤル プランを作成する必要があります。

important重要 :
UM ダイヤル プランはユニファイド メッセージングの動作に不可欠です。既存の UM ダイヤル プランに対する変更は、UM ダイヤル プランに対する変更が及ぼす影響を理解している管理者が行う必要があります。

Set-UMDialplan コマンドレットを実行するには、使用するアカウントに Exchange 組織管理者の役割が委任されている必要があります。

アクセス許可、役割の委任、および Microsoft Exchange Server 2007 を管理するために必要な権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。

パラメータ

パラメータ 必須かどうか 種類 説明

Identity

必須

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

このパラメータには、UM ダイヤル プラン ID を指定します。このパラメータは、UM ダイヤル プランのディレクトリ オブジェクト ID です。このパラメータを使用して、メールボックスをダイヤル プランに、またユニファイド メッセージング サーバーをダイヤル プランにリンクします。

AccessTelephoneNumbers

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

このパラメータには、1 つの有効なボイス メール パイロット番号か、有効なボイス メール パイロット番号の一覧を指定します。この一覧は、ユーザーに対してユニファイド メッセージングが有効になっている場合に、管理者に表示されます。

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

このパラメータには、使用できる国内グループを指定します。各文字列は 4 つの部分で構成されます。

  • グループ名 (最大 32 文字)
  • AllowedNumberString
  • DialNumberString
  • TextComment

ConfiguredInternationalGroups

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

このパラメータには、使用できる国際グループを指定します。各文字列は 4 つの部分で構成されます。

  • グループ名 (最大 32 文字)
  • AllowedNumberString
  • DialNumberString
  • TextComment

Confirm

省略可能

System.Management.Automation.SwitchParameter

このパラメータを指定すると、コマンドの処理が一時停止します。処理を続行するには管理者がコマンドの処理内容を確認する必要があります。既定値は $true です。

ContactAddressList

省略可能

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

このパラメータには、アドレス一覧の ID を指定します。ContactScope パラメータを AddressList に設定した場合は、ディレクトリ検索のスコープが定義されます。

ContactRecipientContainer

省略可能

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

これは、ディレクトリ検索に使用されるコンテナの名前または ID です。

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

このパラメータには、別のフォレストにある同等のダイヤル プランの名前を指定します。テレフォニー ダイヤル プランが 2 つのフォレストにまたがっている場合、2 つ目のダイヤル プラン オブジェクトが作成されると、元のダイヤル プランがもう一方のフォレストのユーザーのプロキシ アドレスにコピーされます。

Extension

省略可能

System.String

このパラメータは、通話が転送されたときに、通話機能によって使用される内線番号を指定します。

FaxEnabled

省略可能

System.Boolean

このパラメータには、システムが FAX をサポートするかどうかを指定します。ダイヤル プランが FAX をサポートしていない場合、ユニファイド メッセージング サーバーは FAX コンポーネントを読み込みません。既定値は $true です。

FDSPollingInterval

省略可能

System.Int32

公開ポイントでファイル配布サービスによる新しいコンテンツの確認が行われる間隔 (分単位) です。範囲は 1 ～ 1,440 分です。既定値は 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

このパラメータには、メッセージの最大記録時間を指定します。This includes all kinds of calls.これには 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 です。

入力の種類

戻り値の種類

エラー

エラー 説明

 

 

例外

例外 説明

 

 

例

最初の例では、外線発信コード 9 を使用する MyUMDialPlan という UM ダイヤル プランを構成します。

2 番目の例では、案内応答を使用する MyUMDialPlan という UM ダイヤル プランを構成します。

3 番目の例では、ダイヤル情報を使用する 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"

参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。