测试并修复本地计算机与其域之间的安全通道。
语法
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 所返回对象的类型。
|
输入 |
None 不能通过管道将输入传递给此 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 返回的值。
另请参阅