Test-CsPresence
上次修改主題的時間： 2012-03-26
測試使用者是否能夠登入 Microsoft Lync Server 2010、發行其目前狀態資訊，以及訂閱另一位使用者發行的目前狀態資訊。
語法
Test-CsPresence -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-PublisherSipAddress <String>] [-RegistrarPort <Nullable>] [-SubscriberSipAddress <String>] [-SubscriberSipAddress <String>]
Test-CsPresence [-TargetFqdn <String>] -PublisherCredential <PSCredential> -PublisherSipAddress <String> -SubscriberCredential <PSCredential> -SubscriberSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-SubscriberSipAddress <String>]
詳細描述
Test-CsPresence 是 Lync Server 2010 綜合交易的範例。Lync Server 中會使用綜合交易來確認使用者可以順利完成一般工作，例如登入系統、交換立即訊息，或打給位於公用交換電話網路 (PSTN) 的電話。這些測試可由系統管理員手動執行，或由 Microsoft System Center Operations Manager (舊稱為 Microsoft Operations Manager) 這類應用程式自動執行。
綜合交易通常以兩種不同的方式進行。許多系統管理員會使用 CsHealthMonitoringConfiguration 指令程式來設定其每個登錄器集區的測試使用者。通常這些使用者是測試帳戶，而不是屬於真正使用者的帳戶。利用設定給集區的這些測試帳戶，系統管理員可以直接對該集區執行綜合交易，而無須指定測試所用使用者帳戶的身分識別 (和其認證)。
或者，系統管理員可以使用實際的使用者帳戶執行綜合交易。例如，如果有兩個使用者無法交換立即訊息，系統管理員可以使用上述兩個使用者帳戶 (而非一組測試帳戶) 執行綜合交易，然後嘗試診斷並解決問題。如果您決定使用實際的使用者帳戶執行綜合交易，則必須提供每位使用者的登入名稱和密碼。
Test-CsPresence 用來判斷一對測試使用者是否可以登入 Lync Server，然後交換目前狀態資訊。若要這樣做，該指令程式會先將兩個使用者登入系統。如果兩者都登入成功，則第一個測試使用者會要求接收第二個使用者的目前狀態資訊。第二個使用者會發行此資訊，而 Test-CsPresence 會驗證該資訊已成功傳輸給第一個使用者。交換目前狀態資訊之後，兩個測試使用者接著會登出 Lync Server。
誰可以執行這個指令程式：若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsPresence"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
TargetFqdn |
必要 |
字串 |
要測試之集區的完整網域名稱 (FQDN)。 |
PublisherCredential |
必要 |
PS 認證物件 |
要測試的兩個使用者帳戶中，第一個使用者帳戶的使用者認證物件。傳遞到 PublisherCredential 的值應該是使用 Get-Credential 指令程式取得的物件參考。例如，這個程式碼會傳回使用者 litwareinc\kenmyer 的認證物件，並將該物件以名稱為 $x 的變數儲存： $x = Get-Credential "litwareinc\kenmyer" 執行此命令時，您需要提供使用者密碼。 如果您要使用集區的狀況監控組態設定執行測試，則不需要發行者認證。 |
PublisherSipAddress |
必要 |
SIP 位址 |
要測試的兩個使用者帳戶中，第一個使用者帳戶的 SIP 位址。例如：-PublisherSipAddress "sip:kenmyer@litwareinc.com"。PublisherSipAddress 參數必須參考與 PublisherCredential 相同的使用者帳戶。 如果您是在集區的狀況監控組態設定下執行測試，則不需要 SIP 位址。 |
SubscriberCredential |
必要 |
PS 認證物件 |
要測試的兩個使用者帳戶中，第二個使用者帳戶的使用者認證物件。傳遞到 SubscriberCredential 的值應該是使用 Get-Credential 指令程式取得的物件參考。例如，此程式碼會傳回使用者 litwareinc\pilar 的認證物件，並將該物件儲存於名為 $y 的變數中： $y = Get-Credential "litwareinc\pilar" 執行此命令時，您需要提供使用者密碼。 如果您要使用集區的狀況監控組態設定執行測試，則不需要訂戶認證。 |
SubscriberSipAddress |
必要 |
SIP 位址 |
要測試的兩個使用者帳戶中，第二個使用者帳戶的 SIP 位址。例如：-SubscriberSipAddress "sip:pilar@litwareinc.com"。SubscriberSipAddress 參數必須參考與 SubscriberCredential 相同的使用者帳戶。 如果您是在集區的狀況監控組態設定下執行測試，則不需要 SIP 位址。 |
RegistrarPort |
選用 |
整數 |
登錄程式服務所使用的 SIP 連接埠。如果登錄程式使用預設連接埠 5061，則不需要這個參數。 |
OutVerboseVariable |
選用 |
字串 |
如果有，執行 Cmdlet 所產生的詳細輸出就會儲存在指定變數中。例如，您可使用下列語法，將輸出儲存於名為 $TestOutput 的變數中： -OutVerboseVariable TestOutput 指定變數名稱時，請勿在前面加上 $ 字元。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
Verbose |
選用 |
字串 |
在指令程式執行時，在畫面上報告詳細的活動。 |
輸入類型
無。Test-CsPresence 不接受管線傳送的輸入。
傳回類型
Test-CsPresence 會傳回 Microsoft.Rtc.SyntheticTransactions.TaskOutput 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Test-CsPresence -TargetFqdn atl-cs-001.litwareinc.com
以上的範例會檢查預先設定的一組測試使用者是否可以登入集區 atl-cs-001.litwareinc.com；測試使用者登入之後，Test-CsPresence 便會檢查兩個使用者是否可以交換目前狀態資訊。只有已針對集區 atl-cs-001.litwareinc.com 定義測試使用者時，此命令才有作用。如果已經定義，則此命令會判斷第一個測試使用者是否可以登入系統，然後檢查此使用者是否可以與針對集區定義之第二個測試使用者交換目前狀態資訊。
如果尚未定義登錄器，則命令會失敗，因為其不知道要用哪些使用者進行測試。如果您未定義集區的測試使用者，則必須加入 SubscriberSipAddress 和 PublisherSipAddress 參數，還有做為目前狀態訂閱者及目前狀態發行者之使用者的對應認證。接著，Test-CsPresence 便會使用兩個指定的使用者進行檢查。
-------------------------- 範例 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsPresence -TargetFqdn atl-cs-001.litwareinc.com -SubscriberSipAddress "sip:pilar@litwareinc.com" -SubscriberCredential $cred1 -PublisherSipAddress "sip:kenmyer@litwareinc.com" -PublisherCredential $cred2
範例 2 所示的命令會測試一對使用者 (litwareinc\pilar 和 litwareinc\kenmyer) 是否能夠登入 Lync Server，然後交換目前狀態資訊。為達成此目的，範例中的第一個命令會使用 Get-Credential 指令程式建立一個包含使用者 Pilar Ackerman 之名稱與密碼的 Windows PowerShell 認證物件。(因為已加上登入名稱 litwareinc\pilar 作為參數，所以系統管理員只需要在 [Windows PowerShell 認證要求] 對話方塊輸入 Pilar Ackerman 帳戶的密碼)。然後，產生的認證物件會以名稱為 $cred1 的變數儲存。第二個命令會執行相同的程序，但這次會傳回 Ken Myer 帳戶的認證物件。
手邊有了這兩個認證物件之後，此範例中的第三個命令會判斷這兩個使用者是否可以登入 Lync Server，然後交換目前狀態資訊。若要執行此工作，會呼叫 Test-CsPresence 並搭配下列參數：TargetFqdn (登錄器集區的 FQDN)、SubscriberSipAddress (某位測試使用者的 SIP 位址)、SubscriberCredential (Windows PowerShell 物件，包含同一位使用者的認證)、PublisherSipAddress (另一位測試使用者的 SIP 位址)，以及 PublisherCredential (Windows PowerShell 物件，包含另一位使用者的認證)。