Test-UMConnectivity

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。

Test-UMConnectivity コマンドレットを使用して、ユニファイドメッセージング (UM) サーバーの操作をテストします。

注: このコマンドレットは、Exchange 2010 で最適に動作します。以降のバージョンの Exchange では、このコマンドレットの機能が Managed Availability に置き換えられました。したがって、このコマンドレットを使用する代わりに、Invoke-MonitoringProbe コマンドレットを使用して関連するアクティブなモニタープローブを指定するのが最良の方法になります。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Test-UMConnectivity
    -Phone <String>
    -PIN <String>
    -TUILogon <Boolean>
    -UMDialPlan <UMDialPlanIdParameter>
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    -Phone <String>
    -UMIPGateway <UMIPGatewayIdParameter>
    [-DiagDtmfDurationInMilisecs <Int32>]
    [-DiagDtmfSequence <String>]
    [-DiagInitialSilenceInMilisecs <Int32>]
    [-DiagInterDtmfDiffGapInMilisecs <String>]
    [-DiagInterDtmfGapInMilisecs <Int32>]
    [-From <String>]
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    -ResetPIN <Boolean>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    -TUILogonAll <Boolean>
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    [-CallRouter]
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

説明

2 つの診断テストは、メールボックスサーバーソフトウェアの動作 (モード 1) と、接続されたテレフォニーコンポーネントを含むシステム全体の動作 (モード 2) をテストするように設計されています。

Test-UMConnectivity コマンドレットを使用すると、メールボックスサーバーと、これに接続されたテレフォニー装置の動作をテストすることができます。 UMIPGateway パラメーターを含めてこのコマンドレットを実行すると、メールボックスサーバーはユニファイドメッセージングシステムの完全なエンドツーエンドの動作をテストします。このテストには、IP ゲートウェイ、Private Branch eXchanges (PBX)、ケーブル接続など、メールボックスサーバーに接続されているテレフォニーコンポーネントが含まれます。 UMIPGateway パラメーターを指定しない場合、メールボックスサーバーは、このサーバーにインストールされ、構成されているユニファイドメッセージングコンポーネントの動作のみをテストします。

オンプレミスのユニファイドメッセージング展開でこのコマンドレットを実行する場合は、コマンドレットがテストしているコンピューターまたはサーバーの UM IP ゲートウェイオブジェクトを作成する必要があります。 UM IP ゲートウェイオブジェクトを作成するときは、完全修飾ドメイン名 (FQDN) で構成する必要があり、その FQDN はこのコマンドレットを実行しているコンピューターの名前と一致する必要があります。

このタスクが完了すると、コマンドレットはメールボックスサーバーと関連するテレフォニーコンポーネントの動作のテストを完了しています。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Test-UMConnectivity

この例では、ローカルのメールボックスサーバーで接続テストと動作テストを実行し、次にボイスオーバー IP (VoIP) 接続情報を表示します。

例 2

Test-UMConnectivity -UMIPGateway MyUMIPGateway -Phone 56780 -Secured $false

この例では、ローカルのメールボックスサーバーが、セキュリティで保護された相互 TLS 接続ではなくセキュリティで保護されていない TCP 接続を使用して、電話番号 56780 を用いて UM IP ゲートウェイ MyUMIPGateway 経由で電話をかけることができるかどうかをテストします。

例 3

Test-UMConnectivity -Phone sip:sipdp.contoso.com@contoso.com -UMIPGateway MyUMIPGateway -Secured $true -From sip:user1@contoso.com -MediaSecured $true

この例では、SIP URI を使用して SIP ダイヤルプランをテストします。この例は、Lync Server または Skype for Business Serverを含む環境で使用できます。

パラメーター

-CallRouter

CallRouter スイッチは、Microsoft Exchange ユニファイドメッセージング通話ルーターサービス (フロントエンド) をテストするかどうかを指定します。このスイッチで値を指定する必要はありません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CertificateThumbprint

CertificateThumbprint パラメーターは、セキュリティで保護された SIP モードおよびセキュリティで保護されているモードに使用する証明書の拇印を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DiagDtmfDurationInMilisecs

DiagDtmfDurationInMilisecs パラメーターは、送信される各桁の存続期間を指定します。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DiagDtmfSequence

DiagDtmfSequence パラメーターは、送信される各桁の順序を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DiagInitialSilenceInMilisecs

DiagInitialSilenceInMilisecs パラメーターは、桁の順序が送信される前にコマンドレットが一時停止する期間 (ミリ秒) を指定します。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DiagInterDtmfDiffGapInMilisecs

DiagInterDtmfDiffGapInMilisecs パラメーターは、診断の順序における桁間の時間をカスタマイズするかどうかを指定します。これはコンマ区切りリストで、NULL のエントリが許可されます。このリストには、複数の値が含まれている必要があります。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DiagInterDtmfGapInMilisecs

DiagInterDtmfGapInMilisecs パラメーターは、桁の順序で送信される桁間の時間 (ミリ秒) を指定します。これは 1 つの値です。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DomainController

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメインコントローラーを指定します。ドメインコントローラーは、完全修飾ドメイン名 (FQDN) で識別します。たとえば、dc01.contoso.com です。

型:	Fqdn
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-From

From パラメーターは、呼び出し元の SIP URI または SIP アドレスを指定します。 Phone パラメーターを使用する場合にのみ使用します。既定の設定は、Phone パラメーターを使用するときに指定する SIP URI です。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ListenPort

ListenPort パラメーターは、要求待ちをする IP ポート番号を指定します。指定しない場合は、IP ポート 9000 が使用されます。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MediaSecured

MediaSecured は、セキュリティで保護された RTP またはセキュリティで保護されていない RTP モードのどちらを使用するかを指定します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MonitoringContext

MonitoringContext パラメーターは、関連する監視イベントとパフォーマンスカウンターを結果に含めるかどうかを指定します。有効な値は次のとおりです。

$true: 監視イベントとパフォーマンスカウンターがコマンドの結果に含まれます。通常、出力が Microsoft System Center Operations Manager (SCOM) に渡されるときに、監視イベントとパフォーマンスカウンターを結果に含めます。
$false: 監視イベントとパフォーマンスカウンターは、コマンドの結果には含まれません。これは既定の値です。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Phone

Phone パラメーターは、テスト呼び出しがリダイレクトされる場合に使用される電話番号またはセッション開始プロトコル (SIP) URI (Uniform Resource Identifier) を指定します。 UM ハントグループに呼び出しを転送するには、PBX に内線番号を構成する必要があります。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PIN

PIN パラメーターは、UM が有効なメールボックスに関連付けられた PIN を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemotePort

RemotePort パラメーターは、呼び出しに使用するポートを指定します。指定しない場合、伝送制御プロトコル (TCP) の既定値は 5060、相互トランスポート層セキュリティ (TLS) の既定値は 5061 です。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ResetPIN

ResetPIN パラメーターでは、現在のサイトにあるすべてのテストメールボックスに対して新しい PIN を生成または再生成するかどうかを指定します。

型:	Boolean
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Secured

Secured パラメーターは、テストがセキュリティで保護された SIP モードで実行されるかどうかを指定します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Timeout

Timeout パラメーターは、テスト操作が終了するまでの待機時間を秒単位で指定します。既定値は 600 秒です。このパラメーターに 60 秒未満の値を設定することはできません。このパラメーターは常に 60 秒以上の値で構成することをお勧めします。このパラメーターの最大値は 1,800 秒です。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TUILogon

TUILogon パラメーターは、コマンドレットによって 1 つ以上の UM が有効なメールボックスへのログオンを試みるかどうかを指定します。メールボックスは UM 対応で、Microsoft Exchange ユニファイドメッセージングサービスを実行しているメールボックスサーバーが属する UM ダイヤルプランに関連付けられている必要があります。既定の設定は $false です。

型:	Boolean
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TUILogonAll

TUILogonAll パラメーターは、現在の Active Directory サイト内のすべてのテストメールボックスに接続するかどうかを指定します。既定の設定は $false です。テストされるアカウントは、New-TestCasConnectivityUser.ps1 スクリプトを呼び出して生成する必要があり、対応するメールボックスは UM 対応である必要があります。それ以外の場合、アクションは実行されません。

型:	Boolean
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UMDialPlan

UMDialPlan パラメーターは、テストする UM ダイヤルプランを指定します。このパラメーターは TUILogon パラメーターと併用する必要があります。

型:	UMDialPlanIdParameter
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UMIPGateway

UMIPGateway パラメーターは、発信テスト呼び出しに使用する UM IP ゲートウェイまたは IP PBX の名前を指定します。

型:	UMIPGatewayIdParameter
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

WhatIf スイッチは、コマンドの操作をシミュレートします。このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。このスイッチで値を指定する必要はありません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。