Test-CsPstnPeerToPeerCall

構文

Test-CsPstnPeerToPeerCall -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]

Test-CsPstnPeerToPeerCall [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]

解説

Test-CsPstnPeerToPeerCall は、Microsoft Lync Server 2010 の "代理トランザクション" の一例です。代理トランザクションは Lync Server 2010 で使用され、システムへのログオン、インスタント メッセージの交換、公衆交換電話網 (PSTN) 上の電話への発信などの一般的なタスクをユーザーが正常に実行できることを検証するものです。これらのテストは、管理者が手動で実行することも、Microsoft System Center Operations Manager (以前の Microsoft Operations Manager) などのアプリケーションから自動で実行することもできます。

代理トランザクションは通常、2 つの異なる方法で実行されます。多くの管理者は、CsHealthMonitoringConfiguration コマンドレットを使用して、各レジストラー プールにテスト ユーザーを設定します。テスト ユーザーとは、代理トランザクションでの使用を目的として構成されている 1 組のユーザーのことです (通常、これらはテスト アカウントであり、実際のユーザーのアカウントではありません)。プールに構成されたテスト ユーザーを使用すると、管理者がテスト用にユーザー アカウント ID を指定したり資格情報を入力したりしなくても、そのプールに対して簡単に代理トランザクションを実行できます。

管理者は、実際のユーザー アカウントを使用して代理トランザクションを実行することもできます。たとえば、2 人のユーザーがインスタント メッセージを交換できない場合、管理者は、問題のある 2 人のユーザー アカウント (2 つのテスト アカウントではなく) を使用して代理トランザクションを実行し、問題の診断と解決を試みることができます。実際のユーザー アカウントを使用して代理トランザクションを実行する場合は、各ユーザーのログオン名とパスワードを入力する必要があります。

Test-CsPstnPeerToPeerCall は、サーバー プラットフォーム モードでも使用できます。その場合は、ユーザーの SIP アドレスのみ指定が必要になります。Lync Server 2010 は、証明書を使用してそれらのユーザーを認証します。

Test-CsPstnPeerToPeerCall コマンドレットを呼び出すと、まずテスト ユーザー 2 人の Lync Server へのログオンが試行されます。ログオンが成功すると、ユーザー 1 からユーザー 2 への PSTN ゲートウェイ経由の呼び出しが試行されます。Test-CsPstnPeerToPeerCall では、テスト ユーザーに割り当てられているダイヤル プラン、音声ポリシー、およびその他のポリシーと構成設定を使用してこの呼び出しを行います。テストが予定どおり実行され、ユーザー 2 が呼び出しに応答できたことが確認されると、両方のテスト アカウントがシステムからログオフします。

Test-CsPstnPeerToPeerCall では、実際に電話で発信します。これにより、接続を確立することができ、ネットワーク全体でデュアルトーン多重周波数 (DTMF) コードを送信できることを検証し、接続を介してメディアを送信できるかどうかを判断します。ただし、その呼び出しにはコマンドレット自体が応答するため、手動で通話を終了する必要はありません (つまり、誰も発信された電話に応答して、切る必要はありません)。

このコマンドレットを実行できるユーザー: このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsPstnPeerToPeerCall"}

パラメーター

入力の種類

なし。Test-CsPstnPeerToPeerCall は、パイプライン処理された入力を受け入れません。

戻り値の種類

Test-CsPstnPeerToPeerCall を実行すると、Microsoft.Rtc.SyntheticTransactions.TaskOutput オブジェクトのインスタンスが戻されます。

例

-------------------------- 例 1 --------------------------

Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com 

上記の例では、1 組の構成済みのテスト ユーザーが atl-cs-001.litwareinc.com というプールにログオンできるかどうかを確認します。テスト ユーザーのログオン後に、Test-CsPstnPeerToPeerCall を実行して、この 2 人のユーザーが PSTN ゲートウェイ経由でピアツーピア通話を行うことができるかどうかを確認します。このコマンドが有効なのは、テスト ユーザーが atl-cs-001.litwareinc.com プール用に定義されている場合だけです。定義されている場合、コマンドを実行すると、最初のテスト ユーザーがシステムにログオンできるかどうかの判定と、このユーザーがプールで定義されている 2 番目のユーザーを呼び出せるかどうかの確認が行われます。

テスト ユーザーが定義されていない場合、テスト実行中に使用するユーザーを認識できないので、コマンドは失敗します。プールのテスト ユーザーが定義されていない場合、およびサーバー プラットフォーム モードで実行していない場合は、SenderSipAddress パラメーターと ReceiverSipAddress パラメーター、およびテスト アカウントとして機能するユーザーの対応する資格情報を追加する必要があります。こうして、Test-CsPstnPeerToPeerCall で、指定した 2 人のユーザーを使用したチェックを実行します。

-------------------------- 例 2 --------------------------

$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"

Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:jhaas@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $cred2

例 2 のコマンドを実行して、ユーザーのペア (litwareinc\pilar と litwareinc\kenmyer) が Lync Server にログオンして PSTN ゲートウェイ経由のピアツーピア通話を行うことができるかどうかをテストします。これを実行するには、最初のコマンド例で Get-Credential コマンドレットを使用して、Pilar Ackerman というユーザーの名前とパスワードを含む、Windows PowerShell 資格情報オブジェクトを作成します (ログオン名 litwareinc\pilar はパラメーターとして含まれているため、管理者は、[Windows PowerShell 資格情報の要求] ダイアログ ボックスに Pilar Ackerman のアカウントのパスワードを入力するだけです)。作成された資格情報オブジェクトは、$cred1 という名前の変数に格納されます。2 番目のコマンドも同じことをしますが、このときは、Ken Myer というアカウントの資格情報オブジェクトを戻します。

3 番目のコマンドでは、2 人のユーザーが 2 つの資格情報オブジェクトを使用して Lync Server にログオンし、PSTN ゲートウェイ経由のピアツーピア通話を行うことができるかどうかを判定します。このタスクを実行するには、Test-CsPstnPeerToPeerCall を呼び出して次のパラメーターを指定します。TargetFqdn (レジストラー プールの FQDN)、SenderSipAddress (1 番目のテスト ユーザーの SIP アドレス)、SenderCredential (1 番目のテスト ユーザーの資格情報を保持している Windows PowerShell オブジェクト)、ReceiverSipAddress (もう一方のテスト ユーザーの SIP アドレス)、および ReceiverCredential (もう一方のテスト ユーザーの資格情報を保持している Windows PowerShell オブジェクト)。

-------------------------- 例 3 --------------------------

Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:jhaas@litwareinc.com" -ReceiverSipAddress "sip:kenmyer@litwareinc.com" 

例 3 は、Test-CsPstnPeerToPeerCall をサーバー プラットフォーム モードで使用する方法を示しています。このモードでは、テスト ユーザーの SIP アドレスを指定しますが、ユーザーの資格情報は含めません。この方法で実行すると、Lync Server 2010 は証明書を使用して 2 人のテスト ユーザーを認証します。

関連項目

その他のリソース

Test-CsPstnOutboundCall