Test-CsPhoneBootstrap
上次修改主題的時間： 2012-03-26
驗證使用者可以使用 Microsoft Lync 2010 Phone Edition 相容裝置登入 Microsoft Lync Server 2010。
語法
Test-CsPhoneBootstrap [-TargetFqdn <String>] -PhoneOrExt <String> -PIN <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-TargetUri <String>] [-UserSipAddress <String>]
詳細描述
為了連線到 Lync Server 2010，Lync 2010 Phone Edition 相容裝置必須使用動態主機設定通訊協定 (DHCP) 擷取 Lync Server 登錄器的位址；這些裝置也必須提供有效的電話號碼和關聯的個人識別碼 (PIN) 讓系統驗證 (此程序稱為「啟動載入」)。Test-CsPhoneBootstrap 指令程式讓系統管理員可以驗證指定的使用者 (使用指派給使用者的電話號碼和 PIN) 是否能從 Lync 2010 Phone Edition 相容裝置登入系統 (執行此測試實際上不需要任何裝置)。
為了讓 Test-CsPhoneBootstrap 可以進行檢查，要測試的使用者帳戶所屬之登錄器集區必須可以用 DHCP 探索。若要判斷登錄器是否可以用此方法探索，可使用 Get-CsRegistrarConfiguration 指令程式並檢查 EnableDHCPServer 屬性的值。如果此屬性設為 False，必須使用 Set-CsRegistrarConfiguration 將屬性值設為 True，使登錄器可以用 DHCP 探索。使用 Enterprise DHCP Server 並設定 Lync Server 特有的選項，也可以達成此目的。
誰可以執行這個指令程式：若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsPhoneBootstrap"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
PhoneOrExt |
必要 |
字串 |
要測試的使用帳戶之電話號碼或分機號碼。例如：-PhoneOrExt "+14255551219"。 |
PIN |
必要 |
字串 |
要測試的使用者帳戶之 PIN。 |
RegistrarPort |
選用 |
整數 |
登錄器服務所使用的 SIP 連接埠。如果登錄器使用預設連接埠 5061，則不需要此參數。 |
TargetFqdn |
選用 |
字串 |
要測試的使用者帳戶所屬之登錄器集區的完整網域名稱 (FQDN)。若未指定，則將會使用 DHCP 探索來尋找登錄器集區。 |
TargetUri |
選用 |
字串 |
憑證佈建服務的 URL。如果未包含此參數，則將使用 DHCP 探索來尋找目標 URI。 |
UserSipAddress |
選用 |
字串 |
文字中所使用之使用者帳戶的 SIP 位址；例如：-UserSipAddress "sip:kenmyer@litwareinc.com"。UserSIPAddress 參數必須參考所提供的電話號碼和 PIN；如果所含的電話號碼和 PIN 不屬於 UserSipAddress 參數指定的使用者，則測試將會失敗。請注意，SIP 位址必須包含 "sip:"首碼。 |
OutVerboseVariable |
選用 |
字串 |
此參數存在時，會以指定的變數儲存執行 Cmdlet 的詳細輸出。例如，若要以名稱為 $TestOutput 的變數儲存輸出，請使用下列語法： -OutVerboseVariable TestOutput 指定變數名稱時，請勿在前面加上 $ 字元。 |
Force |
選用 |
Guid |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
Verbose |
選用 |
字串 |
指令程式執行時，在畫面上的詳細活動報告。 |
輸入類型
無。Test-CsPhoneBootstrap 不會接受管線傳送的輸入。
傳回類型
Test-CsPhoneBootstrap 會傳回 Microsoft.Rtc.SyntheticTransactions.TaskOutput 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Test-CsPhoneBootstrap -PhoneOrExt "+14255551219" -Pin "0712"
範例 1 所示的命令會驗證擁有指定電話號碼和 PIN 的使用者可使用 Lync 2010 Phone Edition 相容裝置連線到 Lync Server。為了執行測試，必須提供使用者的電話號碼 (+14255551219) 和使用者的 PIN 號碼 (0712)。
-------------------------- 範例 2 ------------------------
Test-CsPhoneBootstrap -PhoneOrExt "+14255551219" -Pin "0712" -UserSipAddress "sip:kenmyer@litwareinc.com"
上述命令會驗證擁有指定電話號碼和 PIN 的使用者是否可以使用 Lync 2010 Phone Edition 相容裝置連線到 Lync Server。在此範例中，已加上 UserSipAddress 參數來進行額外檢查：如果擁有該 SIP 位址的使用者和擁有指定電話號碼和 PIN 的使用者不同，則測試將會失敗。