Test-CsPhoneBootstrap
トピックの最終更新日: 2012-03-26
ユーザーが Lync Phone Edition 互換デバイスを使用して Lync Server にログオンできることを検証します。UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010)
構文
Test-CsPhoneBootstrap -PhoneOrExtension <String> -PIN <String> [-Force <SwitchParameter>] [-OutLoggerVariable <String>] [-OutVerboseVariable <String>] [-RegistrarPort <Int32>] [-TargetFqdn <String>] [-TargetUri <String>] [-UserSipAddress <String>]
例
例 1
例 1 に示すコマンドを実行すると、指定した電話番号と PIN を持つユーザーが、Lync Phone Edition 互換デバイスを使用して Lync Server に接続できることが検証されます。テストを実行するには、ユーザーの電話番号 (+14255551219) とユーザーの PIN (0712) を指定する必要があります。
Test-CsPhoneBootstrap -PhoneOrExt "+14255551219" -Pin "0712"
例 2
例 2 では、指定した電話番号と PIN を持つユーザーが、Lync Phone Edition 互換デバイスを使用して Lync Server に接続できるかどうかが検証されます。この例では、追加チェックとして UserSipAddress パラメーターを含めています。そのため、この SIP アドレスを持つユーザーが、指定した電話番号と PIN を持つユーザーと同じでない場合、テストは失敗します。
Test-CsPhoneBootstrap -PhoneOrExt "+14255551219" -Pin "0712" -UserSipAddress "sip:kenmyer@litwareinc.com"
解説
Lync Server に接続するには、Lync Phone Edition 互換デバイスで動的ホスト構成プロトコル (DHCP) を使用して Lync Server レジストラーのアドレスを取得する必要があります。また、システムに承認されるためには、これらのデバイスで有効な電話番号と対応する暗証番号 (PIN) を入力する必要があります (このプロセスは、"ブートストラップ" と呼ばれます)。Test-CsPhoneBootstrap コマンドレットを使用すると、管理者は、特定のユーザーに割り当てられた電話番号と PIN を使用して、そのユーザーが Lync Phone Edition 互換デバイスからシステムにログオンできることを確認できます (テストを実行するために実際にデバイスは必要ありません)。
Test-CsPhoneBootstrap コマンドレットでチェックを実行できるようにするには、テスト対象のユーザー アカウントをホストするレジストラー プールが DHCP を使用して検出できる必要があります。レジストラーがこの方法で検出可能かどうかを判別するには、Get-CsRegistrarConfiguration コマンドレットを使用して、EnableDHCPServer プロパティの値をチェックします。このプロパティが False に設定されている場合、Set-CsRegistrarConfiguration コマンドレットを使用してプロパティ値を True に設定し、レジストラーを DHCP で検出できるようにする必要があります。これは、Enterprise DHCP サーバーを使用して、Lync Server 固有のオプションを構成することでも設定できます。
このコマンドレットを実行できるユーザー: このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsPhoneBootstrap"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
PhoneOrExtension |
必須 |
System.String |
テスト対象のユーザー アカウントの電話番号または内線番号。次に例を示します。-PhoneOrExt "+14255551219"。 |
PIN |
必須 |
System.String |
テスト対象のユーザー アカウントの PIN。 |
Force |
省略可能 |
System.Management.Automation.SwitchParameter |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
OutLoggerVariable |
省略可能 |
System.String |
コマンドレットを実行した結果の詳細な出力が、指定された変数に保存されます。この変数には、出力を HTML あるいは XML ファイルに保存する目的で使用する ToHTML と ToXML のペアのメソッドが含まれます。 $TestOutput という名前のロガー変数に出力を保存するには、以下の構文を使用します。 -OutLoggerVariable TestOutput 注: 変数名を指定するときは、先頭に $ 文字を付けないでください。ロガー変数に格納された情報を HTML ファイルに保存するには、以下のようなコマンドを使用します。 $TestOutput.ToHTML() > C:\Logs\TestOutput.html ロガー変数に保存された情報を XML ファイルに保存するには、以下のようなコマンドを使用します。 $TestOutput.ToXML() > C:\Logs\TestOutput.xml |
OutVerboseVariable |
省略可能 |
System.String |
コマンドレットを実行した結果の詳細な出力が、指定された変数に保存されます。たとえば、$TestOutput という名前の変数に出力を保存するには、次の構文を使用します。 -OutVerboseVariable TestOutput 変数名を指定するときは、先頭に $ 記号を使用しないでください。 |
RegistrarPort |
省略可能 |
System.Int32 |
レジストラー サービスが使用する SIP ポート。レジストラーが既定のポート 5061 を使用する場合、このパラメーターは必要ありません。 |
TargetFqdn |
省略可能 |
System.String |
テスト対象のユーザー アカウントをホストするレジストラー プールの完全修飾ドメイン名 (FQDN)。指定しないと、DHCP の検索が使用されてレジストラー プールが特定されます。 |
TargetUri |
省略可能 |
System.String |
証明書プロビジョニング サービスの URL です。このパラメーターを含めないと、DHCP の検索が使用されてターゲット URI が特定されます。 |
UserSipAddress |
省略可能 |
System.String |
テキスト形式のユーザー アカウントの SIP アドレス。たとえば、-UserSipAddress "sip:kenmyer@litwareinc.com"。UserSipAddress パラメーターは指定した電話番号と PIN を参照する必要があります。指定した電話番号と PIN が UserSipAddress パラメーターで指定したユーザーのものでない場合、テストは失敗します。SIP アドレスには、"sip:" というプレフィックスを含める必要があります。 |
入力の種類
なし。Test-CsPhoneBootstrap コマンドレットは、パイプライン処理された入力を受け入れません。
戻り値の種類
Test-CsPhoneBootstrap コマンドレットは、Microsoft.Rtc.SyntheticTransactions.TaskOutput オブジェクトのインスタンスを戻します。