Repair a computer’s corrupted domain trust relationship with PowerShell, no restart required.
What causes a domain computer to lose its trust relationship?
If you’ve been working in an Active Directory environment long enough, you are bound to encounter a domain-joined computer whose membership becomes invalid. Around our office, we call this “falling off the domain” (which seems to be a common term, though I haven’t found its origin).
The two scenarios I have encountered most often when this happens are:
- A VM or system restore has been performed from a backup prior to a computer’s AD password being changed.
- Someone accidentally adds a computer of the same name to the domain, thereby invalidating the current computer.
Windows events related to a computer falling off the domain
When one of these two scenarios occurs, you will see a logon error of “The trust relationship between this workstation and the primary domain has failed.” You will also see the following events in the Windows System log of the computer with the broken trust relationship:
Event 3210 – Error – NETLOGON
This computer could not authenticate with \\<DC NAME>, a Windows domain controller for domain <DOMAIN>, and therefore this computer might deny logon requests. This inability to authenticate might be caused by another computer on the same network using the same name or the password for this computer account is not recognized. If this message appears again, contact your system administrator.
Event 8019 – Warning – DNS Client Events
The system failed to register host (A or AAAA) resource records (RRs) for network adapter
The reason the system could not register these RRs was because of a security related problem. The cause of this could be (a) your computer does not have permissions to register and update the specific DNS domain name set for this adapter, or (b) there might have been a problem negotiating valid credentials with the DNS server during the processing of the update request.
Event 130 – Warning – Time-Service
NtpClient was unable to set a domain peer to use as a time source because of failure in establishing a trust relationship between this computer and the ‘<DOMAIN>’ domain in order to securely synchronize time. NtpClient will try again in 15 minutes and double the reattempt interval thereafter. The error was: The trust relationship between this workstation and the primary domain failed. (0x800706FD)
Repair computer’s trust relationship with domain
In the past, your option for fixing a computer’s trust relationship with the domain was to remove it from the domain, reboot, re-add it to the domain, and reboot. Not exactly a seamless operation, especially if the system is remote.
In PowerShell 3.0, Microsoft introducted the cmdlet Test-ComputerSecureChannel. It is not telling from the name, but this cmdlet can not only check whether a computer’s domain trust is still valid, but it can repair it if it is not!
Using Test-ComputerSecureChannel to check and repair domain trust relationship
Here is how it works. On my afflicted computer, I am going to open an elevated admin PowerShell session. First thing I am going to do is check the current status of the computer’s domain trust relationship. I can do this by issuing the naked cmdlet.
PS C:\Windows\system32> Test-ComputerSecureChannel
OK. We confirmed our suspicions based on the Windows events we saw in the log. Now let’s work the magic of repairing the trust. I am going to run Test-ComputerSecureChannel with the -Repair parameter.
PS C:\Windows\system32> Test-ComputerSecureChannel -Repair
Test-ComputerSecureChannel : Cannot reset the secure channel password for the computer account in the domain.
Operation failed with the following exception: The user name or password is incorrect.
At line:1 char:1
+ Test-ComputerSecureChannel -Repair
+ CategoryInfo : OperationStopped: (Win10A:String) [Test-ComputerSecureChannel], InvalidOperationExceptio
+ FullyQualifiedErrorId : FailToResetPasswordOnDomain,Microsoft.PowerShell.Commands.TestComputerSecureChannelComma
Why did it fail? Because if you recall earlier, when I attempt to login using a domain user, I was getting the error message “The trust relationship between this workstation and the primary domain has failed.” I am currently signed into the computer using a local Administrator account. I need to use the -Credential parameter and pass in credentials for a domain user that has the rights to add a computer to the domain. To do this, I will use Get-Credential and store it in a variable called $cred. I will then pass that variable into the Test-ComputerSecureChannel cmdlet.
Here is a demo video, as well as the commands and output below.
PS C:\Windows\system32> $cred = Get-Credential
cmdlet Get-Credential at command pipeline position 1
Supply values for the following parameters:
PS C:\Windows\system32> Test-ComputerSecureChannel -Credential $cred -Repair
PS C:\Windows\system32> Test-ComputerSecureChannel
You can see the last cmdlet runs returned True to confirm the domain trust relationship is now valid. I was then able to log out of the computer and log back in with a domain user successfully. No restart required!
- Test-ComputerSecureChannel | docs.microsoft.com
PS C:\Users\aaron> Get-Help Test-ComputerSecureChannel
Tests and repairs the secure channel between the local computer and its domain.
Test-ComputerSecureChannel [-Confirm] [-Credential <PSCredential>] [-Repair] [-Server <String>] [-WhatIf]
The Test-ComputerSecureChannel cmdlet verifies that the channel between the local computer and its domain is
working correctly by checking the status of its trust relationships. If a connection fails, you can use the Repair
parameter to try to restore it. Test-ComputerSecureChannel returns $True if the channel is working correctly and
$False if it is not. This result lets you use the cmdlet in conditional statements in functions and scripts. To
get more detailed test results, use the Verbose parameter.
This cmdlet works much like NetDom.exe. Both NetDom and Test-ComputerSecureChannel use the NetLogon service to
perform the actions.
Online Version: http://go.microsoft.com/fwlink/?LinkId=821645
To see the examples, type: "get-help Test-ComputerSecureChannel -examples".
For more information, type: "get-help Test-ComputerSecureChannel -detailed".
For technical information, type: "get-help Test-ComputerSecureChannel -full".
For online help, type: "get-help Test-ComputerSecureChannel -online"