共用方式為

Test-ComputerSecureChannel

  • 參考
模組:
Microsoft.PowerShell.Management

測試並修復本機計算機與其網域之間的安全通道。

語法

Test-ComputerSecureChannel
    [-Repair]
    [-Server <String>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cmdlet Test-ComputerSecureChannel 會檢查其信任關係的狀態，確認本機計算機與其網域之間的通道是否正常運作。 如果連線失敗，您可以使用 Repair 參數嘗試還原它。

Test-ComputerSecureChannel 如果通道正常運作，則傳回$True;如果通道未正常運作，則傳回$False。 此結果可讓您在函式和腳本的條件語句中使用 Cmdlet。 若要取得更詳細的測試結果，請使用 Verbose 參數。

此 Cmdlet 的運作方式非常類似 NetDom.exe。 NetDom 和使用 Test-ComputerSecureChannel NetLogon 服務來執行動作。

範例

範例 1：測試本機計算機與其網域之間的通道

Test-ComputerSecureChannel

此命令會測試本機計算機與其加入網域之間的通道。

範例 2：測試本機計算機與域控制器之間的通道

Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True

此命令會指定測試的慣用域控制器。

範例 3：重設本機計算機與其網域之間的通道

Test-ComputerSecureChannel -Repair

此命令會重設本機計算機與其網域之間的通道。

範例 4：顯示測試的詳細資訊

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 通用參數來要求作業的詳細訊息。 如需 詳細資訊，請參閱 about_CommonParameters。

範例 5：在執行腳本之前先測試連線

if (!(Test-ComputerSecureChannel)) {
    Write-Host "Connection failed. Reconnect and retry."
}
else {
    &(.\Get-Servers.ps1)
}

此範例示範在執行需要連線的腳本之前，如何使用 Test-ComputerSecureChannel 來測試連線。

語句 if 會檢查執行腳本之前所傳回的值 Test-ComputerSecureChannel 。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Credential

指定具有執行此動作許可權的用戶帳戶。 輸入使用者名稱，例如User01或Domain01\User01，或輸入 PSCredential 物件，例如 Get-Credential Cmdlet 傳回的用戶名稱。 根據預設，Cmdlet 會使用目前用戶的認證。

Credential 參數是針對使用 Repair 參數來修復電腦與網域之間通道的命令所設計。

類型:PSCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Repair

表示此 Cmdlet 會移除，然後重建 NetLogon 服務所建立的通道。 使用此參數嘗試還原測試失敗的連線。

若要使用此參數，目前的用戶必須是本機計算機上的 Administrators 群組成員。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Server

指定要執行命令的域控制器。 如果未指定此參數，此 Cmdlet 會選取作業的預設域控制器。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

None

您無法使用管線將輸入傳送至此 Cmdlet。

輸出

Boolean

如果連線正常運作，且$False不是，則此 Cmdlet 會傳回 $True 。

備註

  • 若要在 Windows Vista 和更新版本的 Windows 作業系統上執行 Test-ComputerSecureChannel 命令，請使用 [以系統管理員身分執行] 選項開啟 Windows PowerShell。
  • Test-ComputerSecureChannel 是使用 I_NetLogonControl2 函式來實作，可控制 Netlogon 服務的各個層面。