測試與修復本機電腦與其網域之間的安全通道。

語法

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 傳回的值。






請參閱




目錄