This is the built-in help made by Microsoft for the command 'Test-ComputerSecureChannel', in PowerShell version 2 - as retrieved from
Windows version 'Microsoft® Windows Vista™ Ultimate ' PowerShell help files on 2016-06-23.
For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.
Tests and repairs the secure channel between the local computer and its domain.
Test-ComputerSecureChannel [-Repair] [-Server <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
The Test-ComputerSecureChannel cmdlet verifies that the secure 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 secure channel is working correctly and "False" if it is not. This result lets you use the cmdle
t 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=137749
Checkpoint-Computer
Restart-Computer
Stop-Computer
Reset-ComputerMachinePassword
<
-------------------------- EXAMPLE 1 --------------------------
C:\PS>test-computersecurechannel
True
Description
-----------
This command tests the secure channel between the local computer and the domain to which it is joined.
-------------------------- EXAMPLE 2 --------------------------
C:\PS>test-computersecurechannel -server DCName.fabrikam.com
True
Description
-----------
This command specifies a preferred domain controller for the test.
-------------------------- EXAMPLE 3 --------------------------
C:\PS>Test-ComputerSecureChannel -repair
True
Description
-----------
This command resets the secure channel between the local computer and its domain.
-------------------------- EXAMPLE 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."
Description
-----------
This command uses the Verbose common parameter to request detailed messages about the operation. For more information about the Verbose parameter
, see about_CommonParameters.
-------------------------- EXAMPLE 5 --------------------------
C:\PS>set-alias tcsc test-computersecurechannel
if (!(tcsc))
{write-host "Connection failed. Reconnect and retry."}
else { &(.\get-servers.ps1) }
Description
-----------
This example shows how to use Test-ComputerSecureChannel to test a connection before running a script that requires the connection.
The first command uses the Set-Alias cmdlet to create an alias for the cmdlet name. This saves space and prevents typing errors.
The If statement checks the value that Test-ComputerSecureChannel returns before running a script.