Test-CsPstnPeerToPeerCall
上次修改主題的時間： 2012-03-25
測試一對使用者是否能在公用交換電話網路 (PSTN) 閘道上進行對等通話。
語法
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) 這類應用程式自動執行。
綜合交易通常以兩種不同的方式進行。許多系統管理員會使用 CsHealthMonitoringConfiguration 指令程式來設定其每個登錄器集區的測試使用者。這些測試使用者是已預先設定要搭配使用綜合交易的一對使用者。(通常這些使用者是測試帳戶，而不是屬於真正使用者的帳戶)。利用對集區設定的測試使用者，系統管理員只要對集區執行綜合交易，無須指定測試中牽涉之使用者帳戶的識別身分 (並提供其認證)。
另一種方式是系統管理員會使用真正的使用者帳戶來執行綜合交易。例如，如果兩個使用者無法交換立即訊息，則系統管理員可以使用這兩個有問題的使用者帳戶 (而非一對測試帳戶) 執行綜合交易，然後嘗試診斷及解決問題。如果您決定使用實際的使用者帳戶執行綜合交易，則必須提供每位使用者的登入名稱和密碼。
Test-CsPstnPeerToPeerCall 也可以在伺服器平台模式中使用。在此案例中，您只需指定使用者的 SIP 位址，Lync Server 2010 將使用憑證來驗證那些使用者。
當您呼叫 Test-CsPstnPeerToPeerCall 時，此指令程式會先嘗試將這兩個測試使用者登入到 Lync Server。假設登入成功，指令程式接著會讓使用者 1 嘗試在 PSTN 閘道上撥打電話給使用者 2；Test-CsPstnPeerToPeerCall 會使用撥號對應表、語音原則，以及其他指派給這名測試使用者的原則與組態設定撥打這通電話。如果測試依計畫進行，指令程式將會確認使用者 2 可以接聽電話，然後將這兩個測試帳戶從系統登出。
Test-CsPstnPeerToPeerCall 會實際撥打一通電話來確認可進行連線，同時跨網路傳輸雙音多頻 (DTMF) 代碼來判斷是否可透過網路傳送媒體。但是，來電是由指令程式本身接聽，不需手動終止來電 (也就是說，不需要人員接聽，然後掛斷撥進來的電話)。
誰可以執行這個指令程式：若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsPstnPeerToPeerCall"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
TargetFqdn |
必要 |
字串 |
要測試之集區的完整網域名稱 (FQDN)。 |
ReceiverCredential |
選用 |
PS 認證物件 |
要測試之兩個使用者帳戶中之第一個的使用者認證物件。傳給 ReceiverCredential 的值應該是以 Get-Credential 指令程式取得的物件參考。例如，此程式碼會傳回使用者 litwareinc\pilar 的認證物件，並將該物件儲存於名為 $y 的變數中： $y = Get-Credential "litwareinc\pilar" 執行此命令時，您需要提供使用者密碼。 如果您是在集區的狀況監控組態下執行測試，或者如果您正在伺服器平台模式中執行，則不需要接收者認證。 |
ReceiverSipAddress |
選用 |
SIP 位址 |
要測試之兩個使用者帳戶中之第一個的 SIP 位址。例如：-ReceiverSipAddress "sip:pilar@litwareinc.com"。ReceiverSIPAddress 參數必須與 ReceiverCredential 參考相同的使用者帳戶。 如果您是在集區的狀況監控組態設定下執行測試，則不需要 SIP 位址。 |
RegistrarPort |
選用 |
整數 |
登錄器服務所使用的 SIP 連接埠。如果登錄器使用預設連接埠 5061，則不需要此參數。 |
SenderCredential |
選用 |
PS 認證物件 |
要測試之兩個使用者帳戶中之第二個的使用者認證物件。傳給 SenderCredential 的值應該是以 Get-Credential 指令程式取得的物件參考。例如，此程式碼會傳回使用者 litwareinc\kenmyer 的認證物件，並將該物件儲存於名為 $x 的變數中： $x = Get-Credential "litwareinc\kenmyer" 執行此命令時，您需要提供使用者密碼。 如果您是在集區的狀況監控組態下執行測試，或者如果您正在伺服器平台模式中執行，則不需要傳送者認證。 |
SenderSipAddress |
選用 |
SIP 位址 |
要測試的兩個使用者帳戶中之，第二個使用者帳戶的 SIP 位址。例如：-SenderSipAddress "sip:kenmyer@litwareinc.com"。SenderSIPAddress 參數必須與 SenderCredential 參考相同的使用者帳戶。 如果您是在集區的狀況監控組態設定下執行測試，則不需要 SIP 位址。 |
OutVerboseVariable |
選用 |
字串 |
此參數存在時，會以指定的變數儲存執行 Cmdlet 的詳細輸出。例如，若要以名稱為 $TestOutput 的變數儲存輸出，請使用下列語法： -OutVerboseVariable TestOutput 指定變數名稱時，請勿在前面加上 $ 字元。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
Verbose |
選用 |
切換參數 |
指令程式執行時，在畫面上的詳細活動報告。 |
輸入類型
無。Test-CsPstnPeerToPeerCall 不會接受管線傳送的輸入。
傳回類型
Test-CsPstnPeerToPeerCall 會傳回 Microsoft.Rtc.SyntheticTransactions.TaskOutput 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com
上述範例會檢查一對預先設定的測試使用者是否可以登入集區 atl-cs-001.litwareinc.com；在測試使用者登入之後，Test-CsPstnPeerToPeerCall 會接著檢查這兩個使用者是否可以在 PSTN 閘道上進行對等通話。只有已針對集區 atl-cs-001.litwareinc.com 定義測試使用者時，此命令才有作用。如果已定義，則命令會判斷第一個使用者是否可以登入系統，然後檢查這個使用者是否可以呼叫針對此集區定義的第二個使用者。
如果尚未定義測試使用者，則此命令將會因為不知道在執行測試時要採用哪些使用者而失敗。如果您未定義集區的測試使用者，而且如果您不是在伺服器平台模式中執行，則必須加上 SenderSipAddress 和 ReceiverSipAddress 參數，以及擔任測試帳戶之使用者的對應認證。然後，Test-CsPstnPeerToPeerCall 會使用這兩個指定的使用者進行檢查。
-------------------------- 範例 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 的變數中。第二個命令會執行相同的動作，只不過這次是傳回 Ken Myer 帳戶的認證物件。
有了這兩個認證物件，範例中的第三個命令會判斷這兩個使用者是否可以登入 Lync Server 並在 PSTN 閘道上進行對等通話。為了執行此作業，會呼叫 Test-CsPstnPeerToPeerCall 並搭配下列參數：TargetFqdn (登錄器集區的 FQDN)、SenderSipAddress (第一位測試使用者的 SIP 位址)、SenderCredential (包含這位相同使用者之憑證的 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 會使用憑證來驗證這兩位測試使用者。