共用方式為

Test-ComputerSecureChannel

  • 參考
模組:
Microsoft.PowerShell.Management

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

語法

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

Description

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

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

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

範例

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

PS C:\> Test-ComputerSecureChannel
True

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

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

PS C:\> Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True

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

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

PS C:\> Test-ComputerSecureChannel -Repair
True

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

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

PS C:\> 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：在執行腳本之前先測試連線

PS C:\> 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 傳回 的值。

參數

-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

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

備註

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