測試與修復本機電腦與其網域之間的安全通道。
語法
Test-ComputerSecureChannel [-Repair] [-Server <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
描述
Test-ComputerSecureChannel Cmdlet 會檢查信任關係的狀態，藉此確認本機電腦與其網域之間的通道能夠正確運作。如果連線失敗，您可以使用 Repair 參數嘗試復原。
如果安全通道正常運作，Test-ComputerSecureChannel 會傳回 "True"，否則傳回 "False"。這個結果可以該您使用在函數與指令碼的條件陳述式中使用該 Cmdlet。若要取得詳細的測試結果，請使用 Verbose 參數。
這個 Cmdlet 的作用與 NetDom.exe 非常類似。NetDom 與 Test-ComputerSecureChannel 都是使用 NetLogon 服務執行動作。
參數
-Repair
移除然後重新建置 NetLogon 服務所建立的安全通道。使用這個參數，嘗試復原沒有通過測試的連線 (傳回 "False")。
若要使用這個參數，目前的使用者必須是本機電腦的 Administrators 群組成員。
|
必要? |
false |
|
位置? |
named |
|
預設值 |
無 |
|
接受管線輸入? |
false |
|
接受萬用字元? |
false |
-Server <string>
使用指定的網域控制站執行命令。如果省略這個參數，則 Test-ComputerSecureChannel 會選取作業的預設網域控制站。
|
必要? |
false |
|
位置? |
named |
|
預設值 |
無 |
|
接受管線輸入? |
false |
|
接受萬用字元? |
false |
-Confirm
在執行命令前先提示確認。
|
必要? |
false |
|
位置? |
named |
|
預設值 |
|
|
接受管線輸入? |
false |
|
接受萬用字元? |
false |
-WhatIf
說明執行命令時將會發生何種情況，但不會實際執行命令。
|
必要? |
false |
|
位置? |
named |
|
預設值 |
|
|
接受管線輸入? |
false |
|
接受萬用字元? |
false |
<CommonParameters>
這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.
輸入和輸出
輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。
|
輸入 |
無 您無法經由管道將輸入輸出至這個 Cmdlet。 |
|
輸出 |
System.Boolean 如果連線正常運作，該 Cmdlet 會傳回 "True"，否則傳回 "False"。 |
附註
若要在 Windows Vista 與較新版本的 Windows 上執行 Test-ComputerSecureChannel 命令，請以 [以系統管理員身分執行] 選項開啟 Windows PowerShell。
Test-ComputerSecureChannel 會透過使用 I_NetLogonControl2 函數來實作，這個函數控制 Netlogon 服務的多種層面。
範例 1
C:\PS>test-computersecurechannel True 描述 ----------- 這個命令測試本機電腦與其所屬網域之間安全通道。
範例 2
C:\PS>test-computersecurechannel -server DCName.fabrikam.com True 描述 ----------- 這個命令指定測試偏好的網域控制站。
範例 3
C:\PS>Test-ComputerSecureChannel -repair True 描述 ----------- 這個命令重新測試本機電腦與其網域之間的安全通道。
範例 4
C:\PS>test-computerSecureChannel -verbose VERBOSE: Performing operation "Test-ComputerSecureChannel" on Target "SERVER01". True VERBOSE: "The secure channel between 'SERVER01' and 'net.fabrikam.com' is alive and working correctly." 描述 ----------- 這個命令使用 Verbose 參數，要求關於作業的詳細訊息。如需 Verbose 參數的詳細資訊，請參閱 about_CommonParameters。
範例 5
C:\PS>set-alias tcsc test-computersecurechannel
if (!(tcsc))
{write-host "Connection failed. Reconnect and retry."}
else { &(.\get-servers.ps1) }
描述
-----------
這個範例示範如何使用 Test-ComputerSecureChannel 測試連線，然後才執行要求連線的指令碼。
第一個命令會使用 Set-Alias Cmdlet 建立 Cmdlet 名稱的別名，這可以節省空間並避免拼錯字。
If 陳述式會在執行指令碼之前，先檢查 Test-ComputerSecureChannel 傳回的值。
請參閱