Les informations fournies dans cette section peuvent vous aider à déterminer si une migration à l’aide des applets de commande Outils de migration de Windows Server a réussi ou échoué. Si des échecs se sont produits, vous pouvez utiliser les informations de cette section pour en identifier les causes.

Résolution des problèmes de migration

Le chemin d’accès du fichier journal de déploiement des Outils de migration de Windows Server est %windir%\Logs\SmigDeploy.log. Les fichiers journaux supplémentaires des Outils de migration de Windows Server sont créés dans les emplacements ci-dessous.

  • %windir%\Logs\ServerMigration.log

  • Dans Windows Server 2008 et Windows Server 2008 R2 : %localappdata%\SvrMig\Log

  • Dans Windows Server 2003 : %userprofile%\Local Settings\Application Data\SvrMig\Log

Si les fichiers journaux de migration ne peuvent pas être créés dans les emplacements ci-dessus, ServerMigration.log et SmigDeploy.log sont créés dans %temp% et les autres journaux sont créés dans %windir%\System32.

Affichage du contenu des objets de résultats des Outils de migration de Windows Server

Toutes les applets de commande des Outils de migration de Windows Server retournent les résultats sous forme d’objets. Vous pouvez enregistrer les objets de résultats et les interroger pour obtenir plus d’informations sur les paramètres et les données qui ont été migrés. Vous pouvez également utiliser les objets de résultats comme entrée pour d’autres commandes et scripts des Windows PowerShell.

Descriptions des objets de résultats

Les applets de commande Import-SmigServerSetting et Export-SmigServerSetting des Outils de migration de Windows Server retournent les résultats dans une liste d’objets MigrationResult. Chaque objet MigrationResult contient des informations sur les données ou le paramètre que l’applet de commande traite, le résultat de l’opération et tout message d’erreur ou d’avertissement associé. Le tableau ci-dessous décrit les propriétés d’un objet MigrationResult.

Nom de la propriétéTypeDéfinition

ItemType

Enum

Type d’élément migré. Les valeurs incluent File, Folder, RegistryKey, Share et EncryptedFile.

ID

String

ID de l’élément migré. Les valeurs valides comprennent Local User, Local Group et DHCP.

Success

Boolean

La valeur True est affichée si la migration a réussi ; dans le cas contraire, la valeur False est affichée.

DetailsList

Liste <MigrationResultDetails>

Liste d’objets MigrationResultDetails.

Les applets de commande Send-SmigServerData et Receive-SmigServerData retournent les résultats dans une liste d’objets MigrationDataResult. Chaque objet MigrationDataResult contient des informations sur les données ou le partage que l’applet de commande traite, le résultat de l’opération, tout message d’erreur ou d’avertissement, et d’autres informations associées. Le tableau ci-dessous décrit les propriétés d’un objet MigrationDataResult.

Nom de la propriétéTypeDéfinition

ItemType

Enum

Type d’élément migré. Les valeurs incluent File, Folder, Share et Encrypted File.

SourceLocation

String

Emplacement source de l’élément, indiqué sous forme de nom de chemin d’accès.

DestinationLocation

String

Emplacement de destination de l’élément, indiqué sous forme de nom de chemin d’accès.

Success

Boolean

La valeur True est affichée si la migration a réussi ; dans le cas contraire, la valeur False est affichée.

Size

Integer

Taille de l’élément, en octets.

ErrorDetails

Liste <MigrationResultDetails>

Objet MigrationResultDetails unique.

Erreur

Enum

Énumération des erreurs qui se sont produites.

WarningMessageList

Liste <String>

Liste de messages d’avertissement.

Le tableau ci-dessous décrit les propriétés des objets inclus dans l’objet MigrationResultDetails qui sont communs aux deux objets MigrationResult et MigrationDataResult.

Nom de la propriétéTypeDéfinition

Id

String

Nom du paramètre de migration associé à l’élément. Les valeurs valides comprennent IPConfig et DNS. Cette propriété est vide pour la migration de données.

Messages

Liste <String>

Liste de messages d’événements détaillés.

DetailCode

Integer

Code d’erreur ou d’avertissement associé à chaque message d’événement.

Severity

Enum

Gravité d’un événement, si des événements se produisent. Les valeurs valides comprennent Information, Error et Warning.

Title

String

Titre de l’objet de résultat. Les valeurs valides incluent l’adresse physique de la carte réseau pour la configuration IP ou le nom d’utilisateur pour la migration de l’utilisateur local.

Exemples

Les exemples suivants indiquent comment stocker la liste des objets de résultats dans une variable, puis utiliser la variable dans une requête pour retourner le contenu des objets de résultats une fois la migration terminée.

Pour stocker une liste d’objets de résultats sous forme de variable pour les requêtes
  1. Pour exécuter une applet de commande et enregistrer le résultat dans une variable, tapez une commande de la forme ci-dessous et appuyez sur Entrée.

    $VariableName = $(Cmdlet)

    Voici un exemple :

    $ImportResult = $(Import-SmigServerSetting -FeatureId DHCP -User all -Group -Path D:\rmt\DemoStore -force –Verbose)

    Cette commande exécute l’applet de commande Import-SmigServerSetting avec plusieurs paramètres spécifiés, puis enregistre les objets de résultats dans la variable ImportResult.

  2. Une fois que l’applet de commande Import-SmigServerSetting a terminé ses opérations, retournez les informations contenues dans l’objet de résultat en tapant une commande de la forme ci-dessous et en appuyant sur Entrée.

    $VariableName

    Dans l’exemple ci-dessous, la variable est nommée ImportResult.

    $ImportResult

    Cette commande retourne les informations contenues dans les objets de résultats qui ont été retournés par Import-SmigServerSetting dans l’exemple indiqué à l’étape 1. Voici un exemple de sortie affichée en appelant la variable ImportResult :

               ItemType  ID                              Success  DetailsList
               --------  --                              -------  -----------
              OSSetting  Local User                         True  {Local User, Loc...
              OSSetting  Local Group                        True  {Local Group, Lo...
         WindowsFeature  DHCP                               True  {}
    

    Chaque ligne de l’échantillon précédent est un résultat de migration pour un élément qui a été migré à l’aide de l’applet de commande Import-SmigServerSetting. Les noms des en-têtes de colonnes sont les propriétés des objets MigrationResult. Vous pouvez introduire ces propriétés dans une autre commande pour retourner plus de détails sur les objets de résultats, comme cela est illustré dans les exemples à l’étape 3 et plus loin.

  3. Pour afficher une propriété spécifique pour tous les objets de résultats de la liste, tapez une commande de la forme ci-dessous et appuyez sur Entrée.

    $<Nom_Variable>| Select-Object -ExpandProperty <Nom_Propriété>

    Voici un exemple :

    $importResult | Select-Object -ExpandProperty DetailsList
  4. Vous pouvez exécuter des requêtes plus avancées pour analyser les objets de résultats à l’aide des applets de commande des Windows PowerShell. Voici des exemples :

    • La commande ci-dessous retourne uniquement les détails des objets de résultats dotés de l’ID Local User.

      $ImportResult | Where-Object { $_.ID -eq "Local User" } | Select-Object -ExpandProperty DetailsList
    • La commande ci-dessous retourne uniquement les détails des objets de résultats dotés de l’ID Local User et dont la gravité du message est égale à Warning.

      $ImportResult | Where-Object { $_.ID -eq "Local User" } | Select-Object -ExpandProperty DetailsList | ForEach-Object { if ($_.Severity -eq "Warning") {$_} }
    • La commande ci-dessous retourne uniquement les détails des objets de résultats dotés de l’ID Local User et qui possèdent également le titre Remote Desktop Users.

      $ImportResult | Where-Object { $_.ID -eq "Local Group" } | Select-Object -ExpandProperty DetailsList | ForEach-Object { if ($_.Title -eq "Remote Desktop Users") {$_} }

Informations supplémentaires sur l’interrogation des résultats

Pour plus d’informations sur les applets de commande utilisés dans les exemples précédents, consultez les ressources supplémentaires ci-dessous.

Pour plus d’informations sur les techniques de script Windows PowerShell, voir Que puis-je faire avec Windows PowerShell ? – Techniques de script (éventuellement en anglais) sur le site Web Centre de scripts de Microsoft (https://go.microsoft.com/fwlink/?LinkId=134862).