Test-ComputerSecureChannel
测试并修复本地计算机与其域之间的安全通道。
语法
Test-ComputerSecureChannel
[-Repair]
[-Server <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Test-ComputerSecureChannel
cmdlet 通过检查本地计算机与其域之间的通道信任关系的状态,来验证通道是否正常工作。 如果连接失败,可以使用 Repair 参数尝试恢复它。
如果通道正常工作,则 Test-ComputerSecureChannel
将返回 $True;否则,返回 $False。 此结果使你可以在函数和脚本的条件语句中使用该 cmdlet。 若要获取更详细的测试结果,请使用 Verbose 参数。
此 cmdlet 的工作原理与 NetDom.exe
非常类似。 NetDom 和 Test-ComputerSecureChannel
均使用 NetLogon 服务执行操作。
示例
示例 1:测试本地计算机与其域之间的通道
Test-ComputerSecureChannel
此命令测试本地计算机与它所加入的域之间的通道。
示例 2:测试本地计算机和域控制器之间的通道
Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True
此命令指定要进行测试的首选域控制器。
示例 3:重置本地计算机与其域之间的通道
Test-ComputerSecureChannel -Repair
此命令重置本地计算机与其域之间的通道。
示例 4:显示有关测试的详细信息
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:运行脚本前测试连接
if (!(Test-ComputerSecureChannel)) {
Write-Host "Connection failed. Reconnect and retry."
}
else {
&(.\Get-Servers.ps1)
}
此示例演示如何使用 Test-ComputerSecureChannel
在运行需要连接的脚本之前测试连接。
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 服务建立的通道,然后再重建该通道。 使用此参数可尝试恢复未通过测试的连接。
若要使用此参数,则当前用户必须是本地计算机上管理员组的成员。
类型: | 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。
输出
如果连接正常工作,则该 cmdlet 将返回 $True
;否则,返回 $False
。
备注
- 若要在 Windows Vista 以及更高版本的 Windows 操作系统上运行
Test-ComputerSecureChannel
命令,请使用“以管理员身份运行”选项打开 Windows PowerShell。 Test-ComputerSecureChannel
通过使用 I_NetLogonControl2 函数来实现,该函数可控制 Netlogon 服务的各个方面。