Microsoft Entra Connect : Informations de référence PowerShell ADConnectivityTools

Article
11/06/2023

La documentation suivante fournit des informations de référence sur le module PowerShell ADConnectivityTools inclus avec Microsoft Entra Connect dans C:\Program Files\Microsoft Azure Active Directory Connect\Tools\ADConnectivityTool.psm1.

Confirm-DnsConnectivity

SYNOPSIS

Détecte les problèmes DNS locaux.

SYNTAX

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

Description

Exécute des tests de connectivité DNS locaux. Pour configurer le connecteur Active Directory, le serveur Microsoft Entra Connect doit avoir la résolution de noms à la fois pour la forêt à laquelle il tente de se connecter et pour les contrôleurs de domaine associés à cette forêt.

EXEMPLES

EXEMPLE 1

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

EXEMPLE 2

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

PARAMETERS

-Forest

Spécifie le nom de la forêt à tester.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

Spécifiez les contrôleurs de domaine à tester.

Type: Array
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Retourne le résultat de ce diagnostic sous la forme d’un PSObject. Non nécessaire pendant l’interaction manuelle avec cet outil.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Confirm-ForestExists

SYNOPSIS

Détermine si une forêt spécifiée existe.

SYNTAX

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

Description

Interroge un serveur DNS pour connaître les adresses IP associées à une forêt.

EXEMPLES

EXEMPLE 1

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

PARAMETERS

-Forest

Spécifie le nom de la forêt à tester.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-FunctionalLevel

SYNOPSIS

Vérifie le niveau fonctionnel de la forêt AD.

SYNTAX

SamAccount

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

ForestFQDN

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

Description

Vérifie que le niveau fonctionnel de la forêt AD est égal ou supérieur à une MinAdForestVersion donnée (WindowsServer2003). Le compte (Domaine\Nom d’utilisateur) et le mot de passe peuvent être demandés.

EXEMPLES

EXEMPLE 1

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

EXEMPLE 2

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

EXEMPLE 3

Confirm-FunctionalLevel -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-Forest

Forêt cible. La valeur par défaut est la forêt de l’utilisateur actuellement connecté.

Type: String
Parameter Sets: SamAccount
Aliases:

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

-ForestFQDN

Objet ForestFQDN cible.

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

La fonction utilise les informations d’identification de l’utilisateur actuellement connecté à l’ordinateur, plutôt que de lui demander des informations d’identification personnalisées.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-NetworkConnectivity

SYNOPSIS

Détecte les problèmes de connectivité de réseau local.

SYNTAX

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

Description

Exécute des tests de connectivité de réseau local.

Pour les tests de mise en réseau locaux, Microsoft Entra Connect doit pouvoir communiquer avec les contrôleurs de domaine nommés sur les ports 53 (DNS), 88 (Kerberos) et 389 (LDAP). La plupart des organisations exécutent DNS sur leurs contrôleurs de domaine, raison pour laquelle ce test est actuellement intégré. Le port 53 doit être ignoré si un autre serveur DNS a été spécifié.

EXEMPLES

EXEMPLE 1

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

EXEMPLE 2

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

PARAMETERS

-DCs

Spécifiez les contrôleurs de domaine à tester.

Type: Array
Parameter Sets: (All)
Aliases:

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

-SkipDnsPort

Si l’utilisateur n’utilise pas les services DNS fournis par le contrôleur de domaine d’ouverture de session ou le site AD, il souhaitera peut-être ignorer la vérification du port 53. Pour que la configuration du connecteur Active Directory réussisse, l’utilisateur doit toujours être en mesure de résoudre _.ldap._tcp.<forestfqdn>.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Retourne le résultat de ce diagnostic sous la forme d’un PSObject. Non nécessaire pendant l’interaction manuelle avec cet outil.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-TargetsAreReachable

SYNOPSIS

Détermine si une forêt spécifiée et ses contrôleurs de domaine associés sont accessibles.

SYNTAX

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

Description

Exécute des tests « ping » (pour vérifier si un ordinateur peut joindre un ordinateur de destination par le biais du réseau et/ou d’Internet)

EXEMPLES

EXEMPLE 1

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

EXEMPLE 2

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

PARAMETERS

-Forest

Spécifie le nom de la forêt à tester.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

Spécifiez les contrôleurs de domaine à tester.

Type: Array
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-ValidDomains

SYNOPSIS

Valide le fait que les domaines dans le ForestFQDN obtenu sont accessibles

SYNTAX

SamAccount

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

ForestFQDN

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

Description

Valide le fait que tous les domaines dans ForestFQDN obtenu sont accessibles en tentant de récupérer DomainGuid et DomainDN. Le compte (Domaine\Nom d’utilisateur) et le mot de passe peuvent être demandés.

EXEMPLES

EXEMPLE 1

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

EXEMPLE 2

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

EXEMPLE 3

Confirm-ValidDomains -ForestFQDN $ForestFQDN -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-Forest

Forêt cible.

Type: String
Parameter Sets: SamAccount
Aliases:

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

-ForestFQDN

Objet ForestFQDN cible.

Type: Forest
Parameter Sets: ForestFQDN
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

La fonction utilise les informations d’identification de l’utilisateur actuellement connecté à l’ordinateur, plutôt que de lui demander des informations d’identification personnalisées.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Confirm-ValidEnterpriseAdminCredentials

SYNOPSIS

Vérifie si un utilisateur dispose d’informations d’identification d’Administrateur d’entreprise.

SYNTAX

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

Description

Recherche si l’utilisateur spécifié dispose d’informations d’identification d’Administrateur d’entreprise. Le compte (Domaine\Nom d’utilisateur) et le mot de passe peuvent être demandés.

EXEMPLES

EXEMPLE 1

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

EXEMPLE 2

Confirm-ValidEnterpriseAdminCredentials -RunWithCurrentlyLoggedInUserCredentials -Verbose

PARAMETERS

-RunWithCurrentlyLoggedInUserCredentials

La fonction utilise les informations d’identification de l’utilisateur actuellement connecté à l’ordinateur, plutôt que de lui demander des informations d’identification personnalisées.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Get-DomainFQDNData

SYNOPSIS

Récupère un DomainFQDN à partir d’une combinaison de compte et de mot de passe.

SYNTAX

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

Description

Tente d’obtenir un objet domainFQDN à partir des informations d’identification fournies. Si le domainFQDN est valide, un DomainFQDNName ou RootDomainName est retourné, en fonction du choix de l’utilisateur. Le compte (Domaine\Nom d’utilisateur) et le mot de passe peuvent être demandés.

EXEMPLES

EXEMPLE 1

Get-DomainFQDNData -DomainFQDNDataType DomainFQDNName -Verbose

EXEMPLE 2

Get-DomainFQDNData -DomainFQDNDataType RootDomainName -RunWithCurrentlyLoggedInUserCredentials

PARAMETERS

-DomainFQDNDataType

Type de données souhaité qui sera récupéré. Actuellement limité à « DomainFQDNName » ou « RootDomainName ».

Type: String
Parameter Sets: (All)
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

La fonction utilise les informations d’identification de l’utilisateur actuellement connecté à l’ordinateur, plutôt que de lui demander des informations d’identification personnalisées.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnExceptionOnError

Paramètre auxiliaire utilisé par la fonction Start-NetworkConnectivityDiagnosisTools

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Get-ForestFQDN

SYNOPSIS

Récupère un ForestFQDN à partir d’une combinaison de compte et de mot de passe.

SYNTAX

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

Description

Tente d’obtenir un ForestFQDN à partir des informations d’identification fournies. Le compte (Domaine\Nom d’utilisateur) et le mot de passe peuvent être demandés.

EXEMPLES

EXEMPLE 1

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

EXEMPLE 2

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

PARAMETERS

-Forest

Forêt cible. La valeur par défaut est le domaine de l’utilisateur actuellement connecté.

Type: String
Parameter Sets: (All)
Aliases:

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

-RunWithCurrentlyLoggedInUserCredentials

La fonction utilise les informations d’identification de l’utilisateur actuellement connecté à l’ordinateur, plutôt que de lui demander des informations d’identification personnalisées.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Start-ConnectivityValidation

SYNOPSIS

Fonction principale.

SYNTAX

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

Description

Exécute tous les mécanismes disponibles qui vérifient que les informations d’identification AD sont valides.

EXEMPLES

EXEMPLE 1

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

PARAMETERS

-Forest

Forêt cible.

Type: String
Parameter Sets: (All)
Aliases:

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

-AutoCreateConnectorAccount

Pour les installations personnalisées : indicateur qui a la valeur $True si l’utilisateur a choisi « Créer un compte AD » dans la fenêtre Compte de forêt AD de l’Assistant Microsoft Entra Connect. $False si l’utilisateur a choisi « Utiliser un compte AD existant ». Pour les installations Express : La valeur de cette variable doit être $True pour les installations Express.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UserName

Paramètre qui préremplit le champ de nom d’utilisateur quand les informations d’identification de l’utilisateur sont demandées.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Start-NetworkConnectivityDiagnosisTools

SYNOPSIS

Fonction principale pour les tests de connectivité réseau.

SYNTAX

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

Description

Exécute des tests de connectivité de réseau local.

EXEMPLES

EXEMPLE 1

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

EXEMPLE 2

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

PARAMETERS

-Forest

Spécifie le nom de la forêt à tester.

Type: String
Parameter Sets: (All)
Aliases:

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

-Credentials

Nom d’utilisateur et mot de passe de l’utilisateur qui exécute le test. Nécessite le même niveau d’autorisations que celui requis pour exécuter l’Assistant 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

Spécifie l’emplacement d’un fichier journal qui contiendra la sortie de cette fonction.

Type: String
Parameter Sets: (All)
Aliases:

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

-DCs

Spécifiez les contrôleurs de domaine à tester.

Type: Array
Parameter Sets: (All)
Aliases:

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

-DisplayInformativeMessage

Indicateur qui permet l’affichage d’un message relatif à l’objectif de cette fonction.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ReturnResultAsPSObject

Retourne le résultat de ce diagnostic sous la forme d’un PSObject. Il n’est pas nécessaire de le spécifier pendant une interaction manuelle avec cet outil.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ValidCredentials

Indique si les informations d’identification tapées par l’utilisateur sont valides. Il n’est pas nécessaire de le spécifier pendant une interaction manuelle avec cet outil.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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