通过

Microsoft Entra Connect：ADConnectivityTools PowerShell 参考

  • 项目

以下文档提供有关 C:\Program Files\Microsoft Azure Active Directory Connect\Tools\ADConnectivityTool.psm1Microsoft Entra Connect 随附的 ADConnectivityTools PowerShell 模块的参考信息。

Confirm-DnsConnectivity

概要

检测本地 Dns 问题。

语法

Confirm-DnsConnectivity [-Forest] <String> [-DCs] <Array> [-ReturnResultAsPSObject] [<CommonParameters>]

描述

运行本地 Dns 连接测试。 若要配置 Active Directory 连接器，Microsoft Entra Connect 服务器必须具有尝试连接到的林的名称解析以及与此林关联的域控制器。

例子

示例 1

Confirm-DnsConnectivity -Forest "TEST.CONTOSO.COM" -DCs "MYDC1.CONTOSO.COM","MYDC2.CONTOSO.COM"

示例 2

Confirm-DnsConnectivity -Forest "TEST.CONTOSO.COM"

参数

-森林

指定要测试的林的名称。

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DC

指定要测试的 DC。

Type: Array
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ReturnResultAsPSObject

以 PSObject 的形式返回此诊断的结果。 在手动与此工具交互期间不需要。

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

此 cmdlet 支持常见参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅about_CommonParameters（https://go.microsoft.com/fwlink/?LinkID=113216）。

Confirm-ForestExists

概要

确定指定的林是否存在。

语法

Confirm-ForestExists [-Forest] <String> [<CommonParameters>]

描述

查询与林关联的 IP 地址的 DNS 服务器。

例子

示例 1

Confirm-TargetsAreReachable -Forest "TEST.CONTOSO.COM"

参数

-森林

指定要测试的林的名称。

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

此 cmdlet 支持常见参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅about_CommonParameters（https://go.microsoft.com/fwlink/?LinkID=113216）。

Confirm-FunctionalLevel

概要

验证 AD 林功能级别。

语法

SamAccount

Confirm-FunctionalLevel -Forest <String> [-RunWithCurrentlyLoggedInUserCredentials] [<CommonParameters>]

ForestFQDN

Confirm-FunctionalLevel -ForestFQDN <Forest> [-RunWithCurrentlyLoggedInUserCredentials] [<CommonParameters>]

描述

验证 AD 林功能级别是否等于或大于给定 MinAdForestVersion（WindowsServer2003）。 可以请求帐户（域\用户名）和密码。

例子

示例 1

Confirm-FunctionalLevel -Forest "test.contoso.com"

示例 2

Confirm-FunctionalLevel -Forest "test.contoso.com" -RunWithCurrentlyLoggedInUserCredentials -Verbose

示例 3

Confirm-FunctionalLevel -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

参数

-森林

目标林。 默认值为当前登录用户的林。

Type: String
Parameter Sets: SamAccount
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForestFQDN

目标 ForestFQDN 对象。

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RunWithCurrentlyLoggedInUserCredentials

该函数将使用当前登录计算机的用户的凭据，而不是从用户请求自定义凭据。

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

此 cmdlet 支持常见参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅about_CommonParameters（https://go.microsoft.com/fwlink/?LinkID=113216）。

Confirm-NetworkConnectivity

概要

检测本地网络连接问题。

语法

Confirm-NetworkConnectivity [-DCs] <Array> [-SkipDnsPort] [-ReturnResultAsPSObject] [<CommonParameters>]

描述

运行本地网络连接测试。

对于本地网络测试，Microsoft Entra Connect 必须能够与端口 53（DNS）、88（Kerberos）和 389（LDAP）上的命名域控制器通信，因此大多数组织在其 DC 上运行 DNS，这就是为什么此测试当前已集成的原因。 如果指定了另一个 DNS 服务器，应跳过端口 53。

例子

示例 1

Confirm-NetworkConnectivity -SkipDnsPort -DCs "MYDC1.CONTOSO.COM","MYDC2.CONTOSO.COM"

示例 2

Confirm-NetworkConnectivity -DCs "MYDC1.CONTOSO.COM","MYDC2.CONTOSO.COM" -Verbose

参数

-DC

指定要测试的 DC。

Type: Array
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SkipDnsPort

如果用户未使用 AD 站点/登录 DC 提供的 DNS 服务，则他们可能需要跳过检查端口 53。 用户仍必须能够解析_.ldap._tcp。<forestfqdn>，以便 Active Directory 连接器配置成功。

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ReturnResultAsPSObject

以 PSObject 的形式返回此诊断的结果。 在手动与此工具交互期间不需要。

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

此 cmdlet 支持常见参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅about_CommonParameters（https://go.microsoft.com/fwlink/?LinkID=113216）。

Confirm-TargetsAreReachable

概要

确定指定的林及其关联的域控制器是否可访问。

语法

Confirm-TargetsAreReachable [-Forest] <String> [-DCs] <Array> [<CommonParameters>]

描述

运行“ping”测试（计算机是否可以通过网络和/或 Internet 访问目标计算机）

例子

示例 1

Confirm-TargetsAreReachable -Forest "TEST.CONTOSO.COM" -DCs "MYDC1.CONTOSO.COM","MYDC2.CONTOSO.COM"

示例 2

Confirm-TargetsAreReachable -Forest "TEST.CONTOSO.COM"

参数

-森林

指定要测试的林的名称。

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DC

指定要测试的 DC。

Type: Array
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

此 cmdlet 支持常见参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅about_CommonParameters（https://go.microsoft.com/fwlink/?LinkID=113216）。

Confirm-ValidDomains

概要

验证获取的林 FQDN 中的域是否可访问

语法

SamAccount

Confirm-ValidDomains [-Forest <String>] [-RunWithCurrentlyLoggedInUserCredentials] [<CommonParameters>]

ForestFQDN

Confirm-ValidDomains -ForestFQDN <Forest> [-RunWithCurrentlyLoggedInUserCredentials] [<CommonParameters>]

描述

尝试检索 DomainGuid 和 DomainDN，验证获取的林 FQDN 中的所有域是否可访问。 可以请求帐户（域\用户名）和密码。

例子

示例 1

Confirm-ValidDomains -Forest "test.contoso.com" -Verbose

示例 2

Confirm-ValidDomains -Forest "test.contoso.com" -RunWithCurrentlyLoggedInUserCredentials -Verbose

示例 3

Confirm-ValidDomains -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

参数

-森林

目标林。

Type: String
Parameter Sets: SamAccount
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForestFQDN

目标 ForestFQDN 对象。

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RunWithCurrentlyLoggedInUserCredentials

该函数将使用当前登录计算机的用户的凭据，而不是从用户请求自定义凭据。

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

此 cmdlet 支持常见参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅about_CommonParameters（https://go.microsoft.com/fwlink/?LinkID=113216）。

Confirm-ValidEnterpriseAdminCredentials

概要

验证用户是否具有企业管理员凭据。

语法

Confirm-ValidEnterpriseAdminCredentials [-RunWithCurrentlyLoggedInUserCredentials] [<CommonParameters>]

描述

搜索提供的用户是否具有企业管理员凭据。 可以请求帐户（域\用户名）和密码。

例子

示例 1

Confirm-ValidEnterpriseAdminCredentials -DomainName test.contoso.com -Verbose

示例 2

Confirm-ValidEnterpriseAdminCredentials -RunWithCurrentlyLoggedInUserCredentials -Verbose

参数

-RunWithCurrentlyLoggedInUserCredentials

该函数将使用当前登录计算机的用户的凭据，而不是从用户请求自定义凭据。

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

此 cmdlet 支持常见参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅about_CommonParameters（https://go.microsoft.com/fwlink/?LinkID=113216）。

Get-DomainFQDNData

概要

从帐户和密码组合中检索 DomainFQDN。

语法

Get-DomainFQDNData [[-DomainFQDNDataType] <String>] [-RunWithCurrentlyLoggedInUserCredentials]
 [-ReturnExceptionOnError] [<CommonParameters>]

描述

尝试从提供的凭据中获取 domainFQDN 对象。 如果 domainFQDN 有效，将返回 DomainFQDNName 或 RootDomainName，具体取决于用户的选择。 可以请求帐户（域\用户名）和密码。

例子

示例 1

Get-DomainFQDNData -DomainFQDNDataType DomainFQDNName -Verbose

示例 2

Get-DomainFQDNData -DomainFQDNDataType RootDomainName -RunWithCurrentlyLoggedInUserCredentials

参数

-DomainFQDNDataType

将检索的所需数据类型。 目前限制为“DomainFQDNName”或“RootDomainName”。

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RunWithCurrentlyLoggedInUserCredentials

该函数将使用当前登录计算机的用户的凭据，而不是从用户请求自定义凭据。

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ReturnExceptionOnError

Start-NetworkConnectivityDiagnosisTools 函数使用的辅助参数

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

此 cmdlet 支持常见参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅about_CommonParameters（https://go.microsoft.com/fwlink/?LinkID=113216）。

Get-ForestFQDN

概要

从帐户和密码组合中检索 ForestFQDN。

语法

Get-ForestFQDN [-Forest] <String> [-RunWithCurrentlyLoggedInUserCredentials] [<CommonParameters>]

描述

尝试从提供的凭据中获取 ForestFQDN。 可以请求帐户（域\用户名）和密码。

例子

示例 1

Get-ForestFQDN -Forest CONTOSO.MICROSOFT.COM -Verbose

示例 2

Get-ForestFQDN -Forest CONTOSO.MICROSOFT.COM -RunWithCurrentlyLoggedInUserCredentials -Verbose

参数

-森林

目标林。默认值为当前登录用户的域。

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RunWithCurrentlyLoggedInUserCredentials

该函数将使用当前登录计算机的用户的凭据，而不是从用户请求自定义凭据。

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

此 cmdlet 支持常见参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅about_CommonParameters（https://go.microsoft.com/fwlink/?LinkID=113216）。

Start-ConnectivityValidation

概要

Main 函数。

语法

Start-ConnectivityValidation [-Forest] <String> [-AutoCreateConnectorAccount] <Boolean> [[-UserName] <String>]
 [<CommonParameters>]

描述

运行验证 AD 凭据是否有效的所有可用机制。

例子

示例 1

Start-ConnectivityValidation -Forest "test.contoso.com" -AutoCreateConnectorAccount $True -Verbose

参数

-森林

目标林。

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AutoCreateConnectorAccount

对于自定义安装：如果用户在Microsoft Entra Connect 向导的 AD 林帐户窗口中选择了“创建新 AD 帐户”，则为$True的标志。 如果用户选择了“使用现有 AD 帐户”，则$False。 对于 Express-installations：对于 Express-installations，此变量的值必须$True。

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-UserName

请求用户凭据时预填充用户名字段的参数。

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

此 cmdlet 支持常见参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅about_CommonParameters（https://go.microsoft.com/fwlink/?LinkID=113216）。

Start-NetworkConnectivityDiagnosisTools

概要

网络连接测试的主要功能。

语法

Start-NetworkConnectivityDiagnosisTools [[-Forest] <String>] [-Credentials] <PSCredential>
 [[-LogFileLocation] <String>] [[-DCs] <Array>] [-DisplayInformativeMessage] [-ReturnResultAsPSObject]
 [-ValidCredentials] [<CommonParameters>]

描述

运行本地网络连接测试。

例子

示例 1

Start-NetworkConnectivityDiagnosisTools -Forest "TEST.CONTOSO.COM"

示例 2

Start-NetworkConnectivityDiagnosisTools -Forest "TEST.CONTOSO.COM" -DCs "DC1.TEST.CONTOSO.COM", "DC2.TEST.CONTOSO.COM"

参数

-森林

指定要测试的林名称。

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-凭据

运行测试的用户的用户名和密码。 它需要运行 Microsoft Entra Connect 向导所需的相同权限级别。

Type: PSCredential
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-LogFileLocation

指定将包含此函数输出的日志文件的位置。

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DC

指定要测试的 DC。

Type: Array
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisplayInformativeMessage

允许显示有关此函数用途的消息的标志。

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ReturnResultAsPSObject

以 PSObject 的形式返回此诊断的结果。 不需要在手动与此工具交互期间指定。

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ValidCredentials

指示用户键入的凭据是否有效。 不需要在手动与此工具交互期间指定。

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

此 cmdlet 支持常见参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅about_CommonParameters（https://go.microsoft.com/fwlink/?LinkID=113216）。