Test-ComputerSecureChannel

發行項
10/30/2009

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

語法

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

請參閱

概念

Checkpoint-Computer
Restart-Computer
Stop-Computer
Reset-ComputerMachinePassword

共用方式為