Présentation de l’outil d’évaluation de la migration SharePoint

  • Article

L’outil d’évaluation de la migration SharePoint est un outil exécutable en ligne de commande simple. Il analyse le contenu de votre batterie de serveurs SharePoint pour vous aider à identifier l’impact de la migration de votre serveur vers SharePoint avec Microsoft 365.

L’outil est conçu pour s’exécuter sans impact sur votre environnement. Vous pouvez donc observer qu’il a besoin d’un à deux jours pour effectuer une analyse de votre environnement. Pendant ce temps, l’outil signale la progression dans la fenêtre de console. Une fois l’analyse terminée, les fichiers de sortie se trouvent dans le répertoire Logs. C’est là que vous trouverez le résumé et des informations plus détaillées sur les scénarios susceptibles d’être affectés par la migration.

Remarque

Pour télécharger l’outil d’évaluation de la migration SharePoint, voir Télécharger l’outil d’évaluation de la migration SharePoint.

Remarque

Pour améliorer la qualité des produits et services Microsoft, l’outil signale des informations statistiques anonymes à Microsoft. Si vous le souhaitez, vous pouvez identifier votre organization lorsque vous y êtes invité à la fin de l’analyse. Si l’outil ne peut pas se connecter à Internet pour signaler ces informations, l’outil fonctionne toujours comme prévu.

Configuration requise

L’outil est conçu pour être exécuté à partir d’une batterie de serveurs SharePoint 2010, 2013 ou 2016 et présente les conditions préalables suivantes :

  • Pour exécuter l’outil, tous les fichiers doivent être extraits de n’importe quel package compressé avant l’exécution.

  • L’outil doit s’exécuter en tant que compte de service de batterie de serveurs. Un compte d’administrateur de batterie de serveurs est acceptable tant que le compte a reçu un accès en lecture à toutes les applications web. Le compte a également besoin d’autorisations de contrôle total explicites surles administrateursdes opérations> etsur les autorisationsde partage> sur l’application de service Profil utilisateur. Il existe une série de vérifications pour s’assurer que le compte dispose des autorisations suffisantes avant d’analyser l’environnement.

  • L’outil prend uniquement en charge les versions anglaises de SharePoint.

Fichiers de configuration

Vous pouvez modifier deux fichiers de configuration pour SMAT :

  • SiteSkipList.csv est installé dans le même répertoire que SMAT.exe. L’ajout de sites à ce fichier CSV indique à SMAT de ne pas inclure ces sites dans la sortie du rapport. Pour obtenir des exemples sur l’ajout de sites à la liste d’évitements, consultez SiteSkipList.csv.

  • ScanDef.json est installé dans le même répertoire que le SMAT. Vous pouvez utiliser ScanDef.json pour activer ou désactiver des analyses individuelles pour SMAT. Ce fichier contient des configurations à évaluer sur SharePoint 2010 et 2013.

Pour désactiver une analyse, recherchez l’entrée dans le fichier ScanDef.json et définissez Activé sur false. Cela est utile s’il existe une analyse dont votre entreprise ne se soucie pas. La désactivation de l’analyse réduit le temps d’exécution global de SMAT.

L’exemple suivant désactive l’analyse des alertes.

{ "Name": "Alerts", "Type": "AlertsScanner", "SupportedVersions": [ "2010", "2013", "2016" ], "ReportCategoryType": "SPSite", "Enabled": false }

SupportedVersion indique à SMAT les versions de SharePoint auxquelles une analyse spécifique s’applique. Par exemple, SharePoint 2010 n’avait pas de compléments SharePoint, de sorte que l’analyseur Applications ne répertorie pas 2010 comme version prise en charge.

{ "Name": "Apps", "Type": "AppsScanner", "SupportedVersions": [ "2013", "2016" ], "ReportCategoryType": "SPSite", "Enabled": true }

Certaines analyses ont des options de configuration supplémentaires. Celles-ci sont configurables dans le fichier ScanDef.json. Toutes les analyses n’ont pas de propriétés configurables. Toutefois, si une analyse a une propriété, il existe une propriété par défaut configurée dans le fichier ScanDef.json qui peut être modifiée. Par exemple, l’analyse SiteTemplateLanguage a un filtre pour exclure les sites anglais [paramètres régionaux 1033]. Si votre équipe a des préoccupations concernant la migration de sites en anglais, vous pouvez modifier le filtre pour inclure ces sites :

{ "Name": "SiteTemplateLanguage", "Type": "SiteTemplateLanguageScanner", "SupportedVersions": [ "2010", "2013", "2016" ], "Property": { "ExcludedLanguages": "" }, "ReportCategoryType": "SPSite", "Enabled": true }

Si vous supprimez ou endommagez le fichier ScanDef.json, une configuration par défaut incorporée dans le fichier exécutable SMAT.exe sera utilisée à la place. Cela est indiqué dans le fichier SMAT.log. Si vous désactivez une analyse ou modifiez une propriété et que vous remarquez que la modification n’est pas récupérée lorsque vous exécutez SMAT.exe, recherchez des détails dans le fichier SMAT.log.

Exécution

Exécutez smat.exe à partir de l’emplacement des fichiers extraits. Pour afficher tous les paramètres disponibles, exécutez : smat.exe /help.

SMAT.exe est un programme de lancement qui détermine vos intentions en fonction des paramètres transmis, puis charge l’application appropriée pour effectuer le travail demandé. En coulisses, trois fichiers exécutables sont chargés d’effectuer le travail :

  • SMAT2010.exe : effectue une évaluation sur les environnements SharePoint 2010.

  • SMAT2013.exe : effectue une évaluation sur les environnements SharePoint 2013.

  • SMIT.exe : effectue le travail de mappage d’identité pour les environnements SharePoint 2010 et 2013.

Remarque

SMIT cesse de fonctionner après le 30 juin 2023 en raison de la dépréciation du service Azure AD Graph. Pour plus d’informations sur la dernière annonce, consultez Important : Retrait d’Azure AD Graph et dépréciation des modules PowerShell. Lorsque vous exécutez SMAT.exe pour effectuer une évaluation à partir de PowerShell.exe, les actions suivantes se produisent. La fenêtre PowerShell s’exécutant SMAT.exe lance l’application pour effectuer le travail. Une fois l’application opérationnelle chargée, le programme de chargement SMAT.exe se termine et retourne le contrôle à l’opérateur. L’outil qui effectue le travail s’exécute dans sa propre fenêtre jusqu’à ce qu’il se termine.

Fichiers journaux

Vous pouvez voir jusqu’à trois fichiers journaux dans le répertoire de sortie :

  • SMAT.log : ce fichier contient toute la journalisation de l’exécution de l’outil. Il contient trois niveaux de journalisation : Informations, Avertissement et Erreurs. Les informations permettent de suivre la progression et de résoudre les problèmes. En règle générale, les avertissements sont des conditions d’erreur attendues. Les erreurs sont des conditions inattendues dans lesquelles nos outils n’ont pas pu déterminer s’ils seront un obstacle à la progression. Celles-ci doivent être examinées.

  • SMAT_Errors.log : contient uniquement les événements Error. Si ce fichier est manquant une fois les outils terminés, cela indique qu’aucune erreur n’a été trouvée.

  • SMATTelemetry.log : contient la journalisation des outils de chargement de télémétrie. Les problèmes rencontrés ici n’ont pas d’impact sur la génération de vos rapports.

Automatisation de l’évaluation

Si vous devez planifier le processus d’évaluation, vous pouvez le faire en exécutant le fichier .exe spécifique. Par exemple, si vous souhaitez configurer une tâche planifiée sur une batterie de serveurs SharePoint 2010 à des fins d’évaluation, vous devez pointer la tâche planifiée vers SMAT2010.exe. Si vous souhaitez écrire un script PowerShell qui a exécuté l’évaluation sur SharePoint 2013, vous devez pointer le script vers SMAT2013.exe.

Tout scénario de script doit utiliser le -q commutateur pour exécuter le fichier .exe en mode silencieux. Ce mode ne fournit aucune sortie à la console et évite tout ce qui demanderait l’entrée à l’opérateur.

En savoir plus

Pour télécharger l’outil de migration SharePoint et pour plus d’informations sur la façon de résoudre les problèmes identifiés dans les rapports d’évaluation, consultez