共用方式為

Microsoft Entra Connect：ADConnectivityTools PowerShell 參考

  • 發行項

下列檔提供中 Microsoft Entra 連線 C:\Program Files\Microsoft Azure Active Directory Connect\Tools\ADConnectivityTool.psm1隨附之 ADConnectivityTools PowerShell 模組的參考資訊。

Confirm-Dns 連線 ivity

簡介

偵測本機 Dns 問題。

語法

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

描述

執行本機 Dns 連線測試。 若要設定 Active Directory 連接器，Microsoft Entra 連線 伺服器必須同時具有它嘗試連線的樹系名稱解析，以及與此樹系相關聯的域控制器。

例子

範例 1

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

範例 2

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

PARAMETERS

-森林

指定要測試的樹系名稱。

Type: String
Parameter Sets: (All)
Aliases:

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

-Dcs

指定要測試的 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>]

描述

查詢 DNS 伺服器，以取得與樹系相關聯的 IP 位址。

例子

範例 1

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

PARAMETERS

-森林

指定要測試的樹系名稱。

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

PARAMETERS

-森林

目標樹系。 預設值是目前登入使用者的樹系。

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-Network 連線 ivity

簡介

偵測局域網路連線問題。

語法

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

描述

執行局域網路連線測試。

針對局域網路測試，Microsoft Entra 連線 必須能夠與埠 53（DNS）、88（Kerberos） 和 389 （LDAP） 上的具名域控制器通訊，這是目前整合此測試的原因。 如果已指定其他 DNS 伺服器，則應該略過埠 53。

例子

範例 1

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

範例 2

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

PARAMETERS

-Dcs

指定要測試的 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 連線 or 組態成功。

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」測試（電腦是否可以透過網路和/或因特網連線到目的地電腦）

例子

範例 1

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

範例 2

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

PARAMETERS

-森林

指定要測試的樹系名稱。

Type: String
Parameter Sets: (All)
Aliases:

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

-Dcs

指定要測試的 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

PARAMETERS

-森林

目標樹系。

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-ValidEnterprise 管理員 Credentials

簡介

驗證使用者是否有 Enterprise 管理員 認證。

語法

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

描述

搜尋所提供的使用者是否有 Enterprise 管理員 認證。 系統可能會要求帳戶（網域\用戶名稱）和密碼。

例子

範例 1

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

範例 2

Confirm-ValidEnterpriseAdminCredentials -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-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

PARAMETERS

-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-Network 連線 ivityDiagnosisTools 函式所使用的輔助參數

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

PARAMETERS

-森林

目標樹系。預設值是目前登入使用者的網域。

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-連線 ivityValidation

簡介

主要函式。

語法

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

描述

執行驗證 AD 認證是否有效的所有可用機制。

例子

範例 1

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

PARAMETERS

-森林

目標樹系。

Type: String
Parameter Sets: (All)
Aliases:

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

-AutoCreate 連線 orAccount

針對自定義安裝：如果使用者在 Microsoft Entra 連線 精靈的 [AD 樹系帳戶] 視窗中選擇 [建立新的 AD 帳戶] ，則為$True旗標。 如果用戶選擇 [使用現有的 AD 帳戶]，$False。 針對快速安裝：此變數的值必須$True Express 安裝。

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-Network 連線 ivityDiagnosisTools

簡介

網路連線測試的主要功能。

語法

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"

PARAMETERS

-森林

指定要測試的樹系名稱。

Type: String
Parameter Sets: (All)
Aliases:

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

-Credentials

執行測試之使用者的使用者名稱和密碼。 它需要執行 Microsoft Entra 連線 Wizard 所需的相同許可權層級。

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

-Dcs

指定要測試的 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）。