Outil de diagnostic : téléchargement et exécution

L’article présente les étapes pour télécharger et utiliser le CoreView Diagnostic Tool via Docker afin de tester les environnements CoreView Hybrid Connector. Il couvre la connexion, le téléchargement de l’image et l’exécution des diagnostics. De plus, il fournit des commandes PowerShell pour les tests de connectivité et de performance, avec des instructions pour enregistrer les résultats et résoudre les problèmes.

Connexion et téléchargement

Connexion

Pour télécharger la dernière image de conteneur du CoreView Diagnostic Tool, veuillez ouvrir une session PowerShell avec des droits administratifs et exécuter les commandes suivantes :

docker login -u XXXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX -p {SecretKey} cvhybridtool.azurecr.io

Télécharger

Une fois les étapes précédentes terminées, vous devez procéder au téléchargement de l’image Docker du Diagnostic Tool. 

Version 2019

Pour la version 2019, veuillez exécuter la commande suivante :

docker pull cvhybridtool.azurecr.io/cvdiagnostictool:2019

Version 2022

Pour la version 2022, veuillez exécuter la commande suivante :

docker pull cvhybridtool.azurecr.io/cvdiagnostictool:2022

Exécuter

Version 2019

Si vous avez précédemment téléchargé la version 2019 du CoreView Diagnostic Tool, veuillez exécuter la commande suivante à la place :

docker run -v c:\temp:c:\temp --rm -it cvhybridtool.azurecr.io/cvdiagnostictool:2019  

Version 2022

Si vous avez précédemment téléchargé la version 2022 du CoreView Diagnostic Tool, veuillez exécuter la commande suivante à la place :

docker run -v c:\temp:c:\temp --rm -it cvhybridtool.azurecr.io/cvdiagnostictool:2022

Étape 1 : sélectionnez le centre de données

Sur l’écran qui apparaît, vous aurez la possibilité de sélectionner votre centre de données. Appuyez sur Entrée pour établir une connexion au CoreView Data Center sélectionné.

Étape 2 : sélectionnez les tests

À partir du menu ci-dessus, vous pouvez sélectionner n’importe quel test que vous souhaitez exécuter pour évaluer si votre CoreView Hybrid Connector fonctionnera dans votre environnement. Appuyez sur la barre d’espace pour sélectionner une option et sur Entrée pour la confirmer.

Vérifications préalables (la sélection de cette option sélectionnera automatiquement les sous-options listées ci-dessous) :

• Vérifier WinRm testera votre configuration du protocole WinRM utilisé pour se connecter à votre contrôleur de domaine Active Directory.
• Valider les points de terminaison simulera les connexions aux points de terminaison Internet utilisés par le CoreView Hybrid Connector.

Vérification on-premises (la sélection de cette option sélectionnera automatiquement les sous-options listées ci-dessous) :

• Vérifier Exchange on-premises testera la connectivité, la méthode d’authentification et les protocoles utilisés pour se connecter à votre serveur Exchange.
• Vérifier Active Directory testera la connectivité et le protocole utilisé pour se connecter à votre contrôleur de domaine Active Directory.
• Établir un runspace PowerShell ouvrira un runspace PowerShell sans aucun module PowerShell déjà chargé, dans lequel vous pourrez saisir manuellement les cmdlets que vous souhaitez tester.

Établir un runspace Powershell

Si vous souhaitez effectuer des tests au-delà des options par défaut du menu du CoreView Diagnostic Tool, cette fonctionnalité vous permet d’ouvrir un runspace PowerShell similaire à celui utilisé par le CoreView Hybrid Connector.

Pour obtenir des informations sur les versions de PowerShell et de ses modules prises en charge par CoreView, consultez l’article sur les versions et fonctionnalités PowerShell prises en charge par CoreView. Assurez-vous de télécharger et d’installer la version du module correspondante sur le CoreView Diagnostic Tool avant de continuer.

Gardez à l’esprit que tout module que vous installez ne sera disponible dans votre runspace que pendant la durée de la session. Quitter le runspace en saisissant « exit » puis en appuyant sur Entrée effacera tous les modules importés et les commandes exécutées.

Vous trouverez ci-dessous une liste de cmdlets qui peuvent être utiles pour tester des connexions supplémentaires avec le CoreView Hybrid Connector à l’aide de cette fonctionnalité du CoreView Diagnostic Tool :

# Enable Tls protocol to perform https connection tests
        [Net.ServicePointManager]::SecurityProtocol = "Tls, Tls11, Tls12, Ssl3"
        # Test Microsoft Connection
        Invoke-webrequest -uri https://www.microsoft.com -UseBasicParsing
        # Test SSL Certificate revokation list
                Invoke-webrequest -uri https://sectigo.com -UseBasicParsing

# Test Exchange Online Connection
                $adUsername = "upn"
                $adPassword = "password" | ConvertTo-SecureString -AsPlainText -Force
                $Credentials = new-object -typename System.Management.Automation.PSCredential -argumentlist $adUsername, $adPassword
                $cs = Get-Credential -Credential $Credentials  
                Connect-ExchangeOnline -Credential $cs

# Test Teams Connection
                [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
                $adPassword = "password"
                $adUsername = "username"
                $adPassword = $adPassword | ConvertTo-SecureString -AsPlainText -Force
                $Credentials = new-object -typename System.Management.Automation.PSCredential -argumentlist $AdUsername, $adPassword
                $cs = Get-Credential -Credential $Credentials
                Connect-MicrosoftTeams -Credential $cs -LogFilePath "c:/temp/teams-logs.txt"
        Get-CsApplicationAccessPolicy | convertTo-Json 

Raccourcis pour se connecter à Active Directory et à Exchange on-premises

Nous avons introduit des raccourcis qui vous permettent de vous connecter rapidement à Active Directory et à Exchange on-premises sans avoir besoin de commandes PowerShell.

Veuillez noter que les raccourcis listés ci-dessous sont disponibles uniquement pour les versions 2019 et 2022.

 

Se connecter à Active Directory

Pour vous connecter à Active Directory, appuyez simplement sur Ctrl + Q. Il vous sera ensuite demandé de saisir votre nom d’utilisateur Active Directory, votre mot de passe et l’URL de connexion. 

Se connecter à Exchange On-Premises 

Pour vous connecter à Exchange On-Premises, appuyez sur Ctrl + W. Il vous sera demandé de saisir votre nom d’utilisateur Exchange, votre mot de passe et l’URL de connexion.

 

 

Diagnostic Tool (la sélection de cette option sélectionnera automatiquement les sous-options listées ci-dessous) :

• Afficher des informations sur l’exécution des tests ci-dessus doit être utilisé en combinaison avec d’autres tests et enregistrera les résultats des tests exécutés dans un fichier situé dans le répertoire C:\temp.
• En savoir plus affichera des informations détaillées sur les options ci-dessus.

Exemple

Par exemple, vous pouvez sélectionner et exécuter : 

• Vérifier WinRm
• Valider les points de terminaison
• Afficher des informations sur l’exécution des tests ci-dessus

et vous trouverez également les résultats affichés dans un fichier JSON enregistré sur votre lecteur C:.