Test-ComputerSecureChannel

参考

模块:: Microsoft.PowerShell.Management

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

语法

Test-ComputerSecureChannel
    [-Repair]
    [-Server <String>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Test-ComputerSecureChannel cmdlet 通过检查其信任关系的状态来验证本地计算机与其域之间的通道是否正常工作。如果连接失败，可以使用修复参数尝试还原它。

如果通道正常工作，Test-ComputerSecureChannel 返回$True;如果通道未正常工作，则返回$False。通过此结果，可以在函数和脚本中的条件语句中使用 cmdlet。若要获取更详细的测试结果，请使用详细参数。

此 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."

此命令使用详细通用参数来请求有关作的详细消息。有关详细的详细信息，请参阅 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 服务建立的通道。使用此参数尝试还原测试失败的连接。

若要使用此参数，当前用户必须是本地计算机上的 Administrators 组的成员。

类型:	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。

输出

Boolean

如果连接正常工作，则此 cmdlet 返回 $True;如果连接未正常，则返回 $False。

备注

若要在 Windows Vista 和更高版本的 Windows作系统上运行 Test-ComputerSecureChannel 命令，请使用“以管理员身份运行”选项打开 Windows PowerShell。
Test-ComputerSecureChannel 是使用 I_NetLogonControl2 函数实现的，该函数控制 Netlogon 服务的各个方面。

通过