Test-CsP2PAV

構文

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

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

解説

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

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

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

Test-CsP2PAV は、2 人のテスト ユーザーがピアツーピアの音声ビデオ (A/V) 会話に参加できるかどうかを判別する場合に使用します。このシナリオをテストするため、2 人のユーザーがコマンドレットによって Lync Server にログオンします。2 つのログオンが正常に行われたら、最初のユーザーが 2 人目のユーザーを A/V 通話に参加するよう招待します。2 人目のユーザーが通話を受諾すると、2 人のユーザー間の接続がテストされ、通話が終了した後、テスト ユーザーはシステムからログオフされます。

Test-CsP2PAV は実際には、A/V 通話を実行しません。マルチメディア情報はテスト ユーザー間で交換されません。その代わりに、適切な接続が確立されているかどうか、2 人のユーザーがこのような通話を行えるかどうかが検証されるだけです。

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

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

パラメーター

入力の種類

なし。Test-CsP2PAV は、パイプ処理された入力を許可しません。

戻り値の種類

Test-CsP2PAV は、Microsoft.Rtc.SyntheticTransactions.TaskOutput オブジェクトのインスタンスを戻します。

例

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

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

上記の例では、あらかじめ構成した 2 人のテスト ユーザーがプール atl-cs-001.litwareinc.com にログオンして、ピアツーピアの音声/ビデオ通話を実施できるかどうかを確認します。このコマンドが有効なのは、テスト ユーザーが atl-cs-001.litwareinc.com プール用に定義されている場合だけです。定義されている場合、2 人のユーザーがシステムにログオンできるかどうか、ログオンできる場合は音声/ビデオ通話で会話できるかどうかを判別します。

テスト ユーザーが定義されていない場合、テスト実行中に使用するユーザーを認識できないため、コマンドは失敗します。プールのテスト ユーザーを定義していない場合は、SenderSipAddress および ReceiverSipAddress パラメーターを指定するとともに、インスタント メッセージの交換に関係のあるユーザーに対応する資格情報を指定する必要があります。Test-CsP2PAV は、2 人の指定のユーザーを使用して、チェックを実施します。

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

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

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

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

2 つの資格情報オブジェクトを取得した後、例の 3 番目のコマンドにより 2 人のユーザーが Lync Server にログオンして、ピアツーピアの音声/ビデオ通話を実施できるかどうかを判別します。このタスクを実行するには、Test-CsP2PAV を呼び出して次のパラメーターを指定します。TargetFqdn (レジストラー プールの FQDN)、SenderSipAddress (最初のテスト ユーザーの SIP アドレス)、SenderCredential (最初のテスト ユーザーの資格情報を含む Windows PowerShell オブジェクト)、ReceiverSipAddress (もう一方のテスト ユーザーの SIP アドレス)、および ReceiverCredential (もう一方のテスト ユーザーの資格情報を含む Windows PowerShell オブジェクト)。

関連項目

その他のリソース

Test-CsAVConference