Partager via

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

  • Article

La documentation suivante fournit des informations de référence sur le module PowerShell ADConnectivityTools inclus dans 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.

SYNTAXE

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 pour la forêt à laquelle il tente de se connecter, ainsi qu’aux 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"

PARAMÈTRES

-Forêt

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 lors de 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.

SYNTAXE

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

DESCRIPTION

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

EXEMPLES

EXEMPLE 1

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

PARAMÈTRES

-Forêt

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

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-FunctionalLevel

SYNOPSIS

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

SYNTAXE

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 à un MinAdForestVersion donné (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

PARAMÈTRES

-Forêt

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 demander des informations d’identification personnalisées à l’utilisateur.

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-NetworkConnectivity

SYNOPSIS

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

SYNTAXE

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

DESCRIPTION

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

Pour les tests de mise en réseau locaux, Microsoft Entra Connect doit être en mesure de 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, ce qui explique pourquoi 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

PARAMÈTRES

-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 de services DNS fournis par le contrôleur de domaine/site AD, il peut être préférable d’ignorer la vérification du port 53. L’utilisateur doit toujours être en mesure de résoudre _.ldap._tcp.<forestfqdn> afin que la configuration du connecteur Active Directory réussisse.

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 lors de 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-TargetsAreReachable

SYNOPSIS

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

SYNTAXE

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

DESCRIPTION

Exécute des tests « ping » (si un ordinateur peut atteindre un ordinateur de destination via le réseau et/ou 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"

PARAMÈTRES

-Forêt

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

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-ValidDomains

SYNOPSIS

Vérifiez que les domaines du nom de domaine complet de forêt obtenu sont accessibles

SYNTAXE

SamAccount

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

ForestFQDN

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

DESCRIPTION

Vérifiez que tous les domaines du nom de domaine complet de forêt 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

PARAMÈTRES

-Forêt

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 demander des informations d’identification personnalisées à l’utilisateur.

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-ValidEnterpriseAdminCredentials

SYNOPSIS

Vérifie si un utilisateur possède des informations d’identification d’administrateur d’entreprise.

SYNTAXE

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

DESCRIPTION

Recherche si l’utilisateur a des 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

PARAMÈTRES

-RunWithCurrentlyLoggedInUserCredentials

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

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).

Get-DomainFQDNData

SYNOPSIS

Récupère un nom de domaine complet (DomainFQDN) d’une combinaison de compte et de mot de passe.

SYNTAXE

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

DESCRIPTION

Tente d’obtenir un objet domainFQDN à partir des informations d’identification fournies. Si le nom de domaineFQDN est valide, un domainFQDNName ou RootDomainName est retourné, selon le 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

PARAMÈTRES

-DomainFQDNDataType

Type de données souhaité qui seront récupérées. 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 demander des informations d’identification personnalisées à l’utilisateur.

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

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).

Get-ForestFQDN

SYNOPSIS

Récupère un nom de domaine complet de forêt à partir d’une combinaison de compte et de mot de passe.

SYNTAXE

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

DESCRIPTION

Tente d’obtenir un nom de domaine complet de forêt à 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

PARAMÈTRES

-Forêt

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 demander des informations d’identification personnalisées à l’utilisateur.

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).

Start-ConnectivityValidation

SYNOPSIS

Fonction principale.

SYNTAXE

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

PARAMÈTRES

-Forêt

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 $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

-Nom d’utilisateur

Paramètre qui préremplifie le champ Nom d’utilisateur lorsque 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

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).

Start-NetworkConnectivityDiagnosisTools

SYNOPSIS

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

SYNTAXE

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

DESCRIPTION

Exécute des tests de connectivité 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"

PARAMÈTRES

-Forêt

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

-Pouvoirs

Nom d’utilisateur et mot de passe de l’utilisateur qui exécute le test. Il 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 d’afficher un message sur 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. Non nécessaire pour spécifier lors de 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

-ValidCredentials

Indique si les informations d’identification tapées par l’utilisateur sont valides. Non nécessaire pour spécifier lors de 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).