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 ダイヤル プランを削除して、新しいダイヤル プランを作成する必要があります。
重要 : |
---|
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 |
このパラメータには、同じダイヤル プラン内のサブスクライバに解決される番号をサブスクライバがダイヤルできるかどうかを指定します。既定値は |
AllowedInCountryOrRegionGroups |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
このパラメータには、ダイヤルできる同じダイヤル グループから国/地域名の一覧を指定します。許可された国/地域グループ名は、UM ダイヤル プランで指定されたグループ名と一致している必要があります。 |
AllowedInternationalGroups |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
このパラメータには、許可されている国際ダイヤル グループ名の一覧を指定します。国際ダイヤル グループ名は、ダイヤル プランに指定されたグループ名に一致している必要があります。 |
AllowExtensions |
省略可能 |
System.Boolean |
このパラメータには、ダイヤル プランの内線番号に対する通話を許可するかどうかを指定します。既定値は |
AudioCodec |
省略可能 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.AudioCodecEnum |
このパラメータには、録音に使用するオーディオ コーデックを指定します。WMA が既定の設定です。 |
AutomaticSpeechRecognitionEnabled |
省略可能 |
System.Boolean |
このパラメータには、ダイヤル プランのメンバであるユーザーに対して音声認識を有効にするかどうかを指定します。 |
CallSomeoneEnabled |
省略可能 |
System.Boolean |
このパラメータには、通話機能を有効にするかどうかを指定します。 |
ConfiguredInCountryOrRegionGroups |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
このパラメータには、使用できる国内グループを指定します。各文字列は 4 つの部分で構成されます。
|
ConfiguredInternationalGroups |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
このパラメータには、使用できる国際グループを指定します。各文字列は 4 つの部分で構成されます。
|
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 コンポーネントを読み込みません。既定値は |
FDSPollingInterval |
省略可能 |
System.Int32 |
公開ポイントでファイル配布サービスによる新しいコンテンツの確認が行われる間隔 (分単位) です。範囲は 1 ~ 1,440 分です。既定値は 5 分です。 |
InCountryOrRegionNumberFormat |
省略可能 |
Microsoft.Exchange.Data.NumberFormat |
このパラメータには、使用するプレフィックス文字列とディレクトリから取得する桁数を指定します。この数字は、同じ国/地域コード内からこのダイヤル プランにダイヤルするときに使用されます。 |
InfoAnnouncementEnabled |
省略可能 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.InfoAnnouncementEnabledEnum |
このパラメータには、情報アナウンスを有効にするかどうかを指定します。このパラメータには、Enabled、Disabled、または Uninterruptible を設定できます。既定値は |
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 |
このパラメータには、名前がタッチトーン入力または音声入力と一致する複数のユーザーを区別するのに使用する選択基準を指定します。次の値を設定できます。
|
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) を要求するかどうかを指定します。このパラメータが |
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 ダイヤル プランまたは自動応答プロンプトを記録できるかどうかを指定します。既定の設定は |
UMAutoAttendant |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.UMAutoAttendantIdParameter |
このパラメータには、発信者がアスタリスク キー (*) を押したときに実行される自動応答を指定します。このパラメータが指定されている場合は、通話機能より優先されます。 |
VoIPSecurity |
省略可能 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.UMVoIPSecurityType |
このパラメータには、ボイスオーバー IP (VoIP) トラフィックが暗号化されるかどうか、または相互トランスポート層セキュリティ (MTLS) を使用して信号チャネルまたは信号とメディア チャネルが暗号化されるかどうかを指定します。既定の設定は |
WelcomeGreetingEnabled |
省略可能 |
System.Boolean |
このパラメータには、カスタム案内応答を有効にするかどうかを指定します。既定値は |
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 を参照してください。