Test-CsClientAuth
上次修改主題的時間： 2012-03-26
判斷使用者是否可以使用從憑證佈建服務下載的憑證登入 Microsoft Lync Server 2010。
語法
Test-CsClientAuth [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-TargetUri <String>]
詳細描述
用戶端憑證提供使用者另一種獲得 Lync Server 2010 驗證的方法。若要判斷使用者是否可以使用用戶端憑證登入系統，您可以執行 Test-CsClientAuth 指令程式。當您執行此 Test-CsClientAuth 時，必須指定登錄器集區和要測試之使用者帳戶的 SIP 位址；您也必須能夠提供使用者的登入名稱和密碼。呼叫 Test-CsClientAuth後，該指令程式會連絡憑證佈建服務，並要求下載指定使用者之任何用戶端憑證的複本。如果可以找到用戶端憑證並下載，則 Test-CsClientAuth 將會嘗試使用該憑證登入。如果登入成功，Test-CsClientAuth 將會登出並報告該測試成功。
如果找不到憑證或無法下載，或者該指令程式無法使用該憑證登入，則 Test-CsClientAuth 將會報告測試失敗。
誰可以執行這個指令程式：若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsClientAuth"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
UserCredential |
必要 |
PS 認證物件 |
測試中要使用之使用者帳戶的使用者認證物件。傳送至 UserCredential 的值應該是使用 Get-Credential 指令程式所取得的物件參考。例如，這個程式碼會傳回使用者 litwareinc\kenmyer 的認證物件，並將該物件以名稱為 $x 的變數儲存： $x = Get-Credential "litwareinc\kenmyer" 執行此命令時，您需要提供使用者密碼。 |
UserSipAddress |
必要 |
SIP 位址 |
測試中要使用之使用者的 SIP 位址。例如：-UserSipAddress sip:kenmyer@litwareinc.com。 |
RegistrarPort |
選用 |
整數 |
登錄程式服務所使用的 SIP 連接埠。如果登錄程式使用預設連接埠 5061，則不需要這個參數。 |
TargetUri |
選用 |
字串 |
憑證佈建服務的 URL。如果未加入此參數，則 Test-CsClientAuth 將會使用針對登錄器集區設定的憑證佈建服務。 |
TargetFqdn |
選用 |
字串 |
要測試用戶端驗證之登錄器集區的完整網域名稱 (FQDN)。例如：-TargetFqdn "atl-cs-001.litwareinc.com"。 |
OutVerboseVariable |
選用 |
字串 |
此參數存在時，會以指定的變數儲存執行 Cmdlet 的詳細輸出。例如，若要以名稱為 $TestOutput 的變數儲存輸出，請使用下列語法： -OutVerboseVariable TestOutput 指定變數名稱時，請勿在前面加上 $ 字元。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
Verbose |
選用 |
切換參數 |
在指令程式執行時，在畫面上報告詳細的活動。 |
輸入類型
無。
傳回類型
Test-CsClientAuth 會傳回 Microsoft.Rtc.SyntheticTransactions.TaskOutput 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
Test-CsClientAuth -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $cred1
範例 1 所示的命令會測試使用者 litwareinc\kenmyer 使用用戶端憑證登入登錄器集區 atl-cs-001.litwareinc.com 的功能。若要執行此工作，範例中的第一個命令會使用 Get-Credential 建立認證物件以供上述的使用者使用。產生的認證物件 (需要您輸入使用者的密碼) 會以名稱為 $cred1 變數儲存。
接著，第二個命令會呼叫 Test-CsClientAuth，指定登錄器集區的 FQDN (TargetFqdn)、使用者的 SIP 位址 (UserSipAddress) 以及在初始命令中建立的認證物件 (UserCredential)。