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é | Type | Dé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é | Type | Dé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é | Type | Dé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 |
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.
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.
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
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") {$_} }
- La commande ci-dessous retourne uniquement les détails des objets de résultats dotés de l’ID Local User.
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.
Where-Object (éventuellement en anglais) sur le site Web Centre de scripts de Microsoft (https://go.microsoft.com/fwlink/?LinkId=134853).Select-Object (éventuellement en anglais) sur le site Web Centre de scripts de Microsoft (https://go.microsoft.com/fwlink/?LinkId=134858).ForEach-Object (éventuellement en anglais) sur le site Web Centre de scripts de Microsoft (https://go.microsoft.com/fwlink/?LinkId=134860).
Pour plus d’informations sur les techniques de script Windows PowerShell, voir