Test-CsTrunkConfiguration
トピックの最終更新日: 2012-03-27
電話番号と照らし合わせてトランク構成を検証します。
構文
Test-CsTrunkConfiguration -DialedNumber <PhoneNumber> -TrunkConfiguration <TrunkConfiguration>
解説
このコマンドレットを使用して、ダイヤルした電話番号に対してトランク構成が正常に実行されていることを確認します。それぞれの構成には、特定の設定が含まれます。この設定は、仲介サーバー と、公衆交換電話網 (PSTN) ゲートウェイ、IP-PBX、サービス プロバイダーのセッション境界コントローラー (SBC) のいずれかとの間の関係および機能を定義するものです。これらの設定では、このトランクでメディア バイパスが有効かどうか、特定の条件下でリアルタイム転送制御プロトコル (RTCP) パケットを送信するかどうか、セキュア リアルタイム プロトコル (SRTP) 暗号化を要求するかどうかなどを構成します。
このコマンドレットを実行できるユーザー: 既定では、次のグループのメンバーが、Test-CsTrunkConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsTrunkConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
DialedNumber |
必須 |
電話番号 |
構成をテストする電話番号。 |
TrunkConfiguration |
必須 |
TrunkConfiguration |
テストを実行するトランク構成オブジェクトへの参照。トランク構成オブジェクトを取得するには、Get-CsTrunkConfiguration コマンドレットを呼び出します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration オブジェクトです。トランク構成オブジェクトのパイプライン処理された入力を受け入れます。
戻り値の種類
Microsoft.Rtc.Management.Voice.TrunkConfigurationTestResult 型の値を戻します。
例
-------------------------- 例 1 --------------------------
$tc = Get-CsTrunkConfiguration -Identity Site:Redmond
Test-CsTrunkConfiguration -DialedNumber 4255551212 -TrunkConfiguration $tc
この例では、Redmond サイトに定義されているトランク構成に対してテストを実行します。この例の 1 行目では、Get-CsTrunkConfiguration コマンドレットを呼び出して、Redmond サイトの構成 (site:Redmond という Identity を持つ構成) を取得します。取得したトランク構成オブジェクトは変数 $tc に割り当てられます。
2 行目では、Test-CsTrunkConfiguration を呼び出して、テストする電話番号を DialedNumber パラメーターに渡し、1 行目で取得したトランク構成 ($tc に格納) を TrunkConfiguration パラメーターに渡します。