Test-ComputerSecureChannel

项目
10/30/2009

测试并修复本地计算机与其域之间的安全通道。

语法

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 所返回对象的类型。

输入

无

不能通过管道将输入传递给此 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 返回的值。

另请参阅

概念

Checkpoint-Computer
Restart-Computer
Stop-Computer
Reset-ComputerMachinePassword

通过