Test-CsPstnOutboundCall
上次修改主題的時間： 2012-03-26
測試使用者撥打位於公用交換電話網路 (PSTN) 之電話號碼的功能。
語法
Test-CsPstnOutboundCall -TargetFqdn <String> -TargetPstnPhoneNumber <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsPstnOutboundCall [-TargetFqdn <String>] -TargetPstnPhoneNumber <String> -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
詳細描述
Test-CsPstnOutboundCall 是 Microsoft Lync Server 2010「綜合交易」的範例。Lync Server 2010 中會使用綜合交易來確認使用者可以順利完成一般工作，例如登入系統、交換立即訊息，或打給位於公用交換電話網路 (PSTN) 的電話。這些測試可由系統管理員手動執行，或由 Microsoft System Center Operations Manager (舊稱為 Microsoft Operations Manager) 這類應用程式自動執行。
綜合交易通常以兩種不同的方式進行。許多系統管理員會使用 CsHealthMonitoringConfiguration 指令程式來設定其每個登錄器集區的測試使用者。這些測試使用者是已預先設定要搭配使用綜合交易的一對使用者。(通常這些使用者是測試帳戶，而不是屬於真正使用者的帳戶)。利用對集區設定的測試使用者，系統管理員只要對集區執行綜合交易，無須指定測試中牽涉之使用者帳戶的識別身分 (並提供其認證)。
或者，系統管理員可以使用實際的使用者帳戶執行綜合交易。例如，如果有兩個使用者無法交換立即訊息，系統管理員可以使用上述兩個使用者帳戶 (而非一組測試帳戶) 執行綜合交易，然後嘗試診斷並解決問題。如果您決定使用實際的使用者帳戶執行綜合交易，則必須提供每位使用者的登入名稱和密碼。
Test-CsPstnOutboundCall 也可以在伺服器平台模式中使用。在此情況下，您只需要指定使用者的 SIP 位址，Lync Server 2010 會使用憑證來驗證該使用者。
當您執行 Test-CsPstnOutboundCall 時，指令程式會先嘗試將測試使用者登入到 Lync Server。如果登入成功，則此指令程式會嘗試跨 PSTN 閘道撥打電話。這通電話將會使用撥號對應表、語音原則及其他指派給測試帳戶的原則和設定來撥打。接聽來電時，指令程式會透過網路傳送雙音多頻 (DTMF) 碼，以驗證媒體連線。
進行測試時，Test-CsPstnOutboundCall會撥打實際的電話：目標電話將會響鈴，而且必須接聽以測試是否成功。這通電話也必須由系統管理員手動結束。
誰可以執行這個指令程式：若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsPstnOutboundCall"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
TargetFqdn |
必要 |
字串 |
要測試之集區的完整網域名稱 (FQDN)。 |
TargetPstnPhoneNumber |
必要 |
字串 |
進行測試時所要撥打的 PSTN 電話號碼。建議以 E.164 格式指定目標電話號碼，這表示號碼會類似 "+14255551298"，號碼中含有加號 (+)，後面接著國家/地區撥接碼 (1)、區碼 (425) 和電話號碼 (5551298)。指定電話號碼時，請勿使用虛線、括弧或其他任何字元。 如果不採用 E.164 格式，測試使用者的撥號對應表會附加至號碼尾端。然後，Lync Server 2010 會使用該撥號對應表將號碼正規化為 E.164 格式。如果無法正規化號碼，則無法撥打電話，測試將會失敗。 |
UserCredential |
選用 |
PS 認證物件 |
要測試之帳戶的使用者認證物件。傳送至 UserCredential 的值應該是使用 Get-Credential 指令程式所取得的物件參考。例如，這個程式碼會傳回使用者 litwareinc\kenmyer 的認證物件，並將該物件以名稱為 $x 的變數儲存： $x = Get-Credential "litwareinc\kenmyer" 執行此命令時，您需要提供使用者密碼。 如果命令使用以 CsHealthMonitoringConfiguration 指令程式所設定的測試使用者，則不需要此參數。如果在伺服器平台模式中執行測試，也不需要指定此參數。在此情況下，Lync Server 2010 會嘗試使用憑證來驗證使用者。 |
UserSipAddress |
選用 |
SIP 位址 |
要測試之使用者帳戶的 SIP 位址。例如：-SenderSipAddress "sip:kenmyer@litwareinc.com"。UserSipAddress 參數必須參考與 UserCredential 相同的使用者帳戶。 如果命令使用以 CsHealthMonitoringConfiguration 指令程式所設定的測試使用者，則不需要此參數。 |
OutVerboseVariable |
選用 |
字串 |
如果有，執行 Cmdlet 所產生的詳細輸出就會儲存在指定變數中。例如，您可使用下列語法，將輸出儲存於名為 $TestOutput 的變數中： -OutVerboseVariable TestOutput 指定變數名稱時，請勿在前面加上 $ 字元。 |
RegistrarPort |
選用 |
整數 |
登錄程式服務所使用的 SIP 連接埠。如果登錄程式使用預設連接埠 5061，則不需要這個參數。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
Verbose |
選用 |
字串 |
在指令程式執行時，在畫面上報告詳細的活動。 |
輸入類型
無。Test-CsPstnOutboundCall 不接受管線傳送的輸入。
傳回類型
Test-CsPstnOutboundCall 會傳回 Microsoft.Rtc.SyntheticTransactions.TaskOutput 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -TargetPstnPhoneNumber "+15551234567"
以上範例會檢查預先設定的測試使用者是否可以登入集區 atl-cs-001.litwareinc.com，然後撥打跨 PSTN 閘道的電話。只有已針對集區 atl-cs-001.litwareinc.com 定義測試使用者時，此命令才有作用。如果已經定義，則此命令將會判斷第一個測試使用者是否可以登入系統，並且 (如果可以登入) 撥打位於 PSTN 網路的電話。
如果尚未定義測試使用者，則此命令將會因為不知道在執行測試時要採用哪個使用者而失敗。如果您未定義集區的測試使用者，則必須加入 UserSipAddress 參數及參與測試之使用者帳戶的對應認證。接著，Test-CsPstnOutboundCall 將會使用指定的使用者進行其檢查。
-------------------------- 範例 2 --------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -TargetPstnPhoneNumber "+15551234567" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $cred1
範例 2 所示的命令會測試測試使用者 (litwareinc\kenmyer) 登入 Lync Server 的功能，然後跨 PSTN 閘道撥打電話。為達成此目的，範例中的第一個命令會使用 Get-Credential 指令程式建立一個包含使用者 Ken Myer 之名稱與密碼的 Windows PowerShell 認證物件。(因為已加上登入名稱 litwareinc\kenmyer 作為參數，所以系統管理員只需要在 [Windows PowerShell 認證要求] 對話方塊輸入 Ken Myer 帳戶的密碼)。然後，產生的認證物件會以名稱為 $cred1 的變數儲存。
有了認證物件之後，範例中的第二個命令會判斷測試使用者是否可以登入 Lync Server，然後撥打目標電話號碼 (+15551234567)。若要執行此工作，會呼叫 Test-CsPstnOutboundCall 並搭配下列參數：TargetFqdn (登錄器集區的 FQDN)、UserSipAddress (撥打電話之使用者的 SIP 位址)、UserCredential (包含測試使用者認證的 Windows PowerShell 物件) 和 TargetPstnPhoneNumber (要撥打的電話號碼)。
-------------------------- 範例 3 --------------------------
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress sip:kenmyer@litwareinc.com -TargetPstnPhoneNumber "+15551234567"
範例 3 顯示如何在伺服器平台模式中使用 Test-CsPstnOutboundCall。在此模式中，已指定使用者的 SIP 位址，但不包含使用者認證。這樣執行時，Lync Server 2010 會使用憑證來驗證測試使用者。