La información de esta sección puede ayudarlo a determinar si la migración mediante Herramientas de migración de Windows Server cmdlets se completó correctamente o no. Si se produjeron errores, puede usar la información en esta sección para ayudarlo a investigar el origen de los errores.
Solución de problemas de migración
El archivo de registro de implementación de Herramientas de migración de Windows Server se encuentra en %windir%\Logs\SmigDeploy.log. Se crean archivos de registro de Herramientas de migración de Windows Server adicionales en las siguientes ubicaciones.
- %windir%\Logs\ServerMigration.log
- En Windows Server 2008 y Windows Server 2008 R2: %localappdata%\SvrMig\Log
- En Windows Server 2003: %userprofile%\Local Settings\Application Data\SvrMig\Log
Si no se pueden crear archivos de registro de migración en las ubicaciones anteriores, se crean ServerMigration.log y SmigDeploy.log en %temp%; además, se crean otros registros en %windir%\System32.
Ver el contenido de los objetos de resultados de las Herramientas de migración de Windows Server
Todos los cmdlets de Herramientas de migración de Windows Server devuelven los resultados como objetos. Puede guardar los objetos de resultados y consultarlos para obtener más información acerca de la configuración y datos migrados. También puede usar los objetos de resultados como entradas para otros comandos y scripts de Windows PowerShell.
Descripción de los objetos de resultados
Los cmdlets Herramientas de migración de Windows Server Import-SmigServerSetting y Export-SmigServerSetting devuelven los resultados en una lista de objetos de MigrationResult. Cada objeto de MigrationResult contiene información sobre los datos o configuración que el cmdlet procesa, el resultado de la operación y los mensajes de error o advertencia relacionados. La siguiente tabla describe las propiedades de un objeto de MigrationResult.
Nombre de propiedad | Tipo | Definición |
---|---|---|
ItemType | Enum | El tipo de elemento migrado. Los valores incluyen File, Folder, RegistryKey, Share y EncryptedFile. |
ID | Cadena | El identificador del elemento migrado. Algunos ejemplos de valores son Local User, Local Group y DHCP. |
Success | Booleano | Se muestra el valor True si la migración se realizó correctamente; de lo contrario, se muestra False. |
DetailsList | Lista de <detallesResultadoMigración> | Una lista de los objetos de MigrationResultDetails. |
Los cmdlets Send-SmigServerData y Receive-SmigServerData devuelven los resultados en una lista de objetos de MigrationDataResult. Cada objeto de MigrationDataResult contiene información sobre los datos o recurso compartido que el cmdlet procesa, el resultado de la operación, los errores o mensajes de advertencia y otra información relacionada. La siguiente tabla describe las propiedades de un objeto de MigrationDataResult.
Nombre de propiedad | Tipo | Definición |
---|---|---|
ItemType | Enum | El tipo de elemento migrado. Los valores incluyen File, Folder, Share y Encrypted File. |
SourceLocation | Cadena | La ubicación de origen del elemento, mostrado como nombre de ruta de acceso. |
DestinationLocation | Cadena | La ubicación de destino del elemento, mostrado como nombre de ruta de acceso. |
Success | Booleano | Se muestra el valor True si la migración se realizó correctamente; de lo contrario, se muestra False. |
Size | Entero | El tamaño del elemento, en bytes. |
ErrorDetails | Lista de <detallesResultadoMigración> | Un único objeto de MigrationResultDetails. |
Error | Enum | Enumeración de los errores que se produjeron. |
WarningMessageList | Lista de <Cadena> | Una lista de mensajes de advertencia. |
La siguiente tabla describe las propiedades de los objetos dentro del objeto de MigrationResultDetails que son comunes a los objetos MigrationResult y MigrationDataResult.
Nombre de propiedad | Tipo | Definición |
---|---|---|
Id | Cadena | El nombre de la configuración de migración que está relacionada con el elemento. Algunos ejemplos de valores son IPConfig y DNS. Esta propiedad no contiene migración de datos. |
Messages | Lista de <Cadena> | Una lista detallada de mensajes de evento. |
DetailCode | Entero | El código de error o advertencia asociado con cada mensaje de evento. |
Severity | Enum | La gravedad de un evento, si es que ocurre uno. Algunos ejemplos de valores son Information, Error y Warning. |
Title | Cadena | El título del objeto de resultado. Algunos ejemplos de valores incluyen la dirección física de la NIC para la configuración IP o el nombre de usuario para la migración de usuario local. |
Ejemplos
Los siguientes ejemplos muestran cómo almacenar la lista de los objetos de resultados en una variable y, a continuación, usar la variable en una consulta para devolver el contenido de los objetos de resultados una vez finalizada la migración.
Para almacenar una lista de objetos de resultados como una variable para consultas |
Para ejecutar un cmdlet y guardar el resultado en una variable, escriba un comando con el siguiente formato y después presione Entrar.
$VariableName = $(Cmdlet)
A continuación se muestra un ejemplo.
$ImportResult = $(Import-SmigServerSetting -FeatureId DHCP -User all -Group -Path D:\rmt\DemoStore -force –Verbose)
Este comando ejecuta el cmdlet Import-SmigServerSetting con varios parámetros especificados y, a continuación, guarda los objetos de resultados en la variable ImportResult.
Una vez que el cmdlet Import-SmigServerSetting finaliza sus operaciones, devuelva la información que contiene el objeto de resultado escribiendo un comando con el siguiente formato y, a continuación, presionado Entrar.
$VariableName
En el siguiente ejemplo, la variable lleva el nombre ImportResult.
$ImportResult
Este comando devuelve la información contenida en los objetos de resultados devueltos por Import-SmigServerSetting en el ejemplo del paso 1. A continuación se presenta un ejemplo de la salida que se muestra al llamar la variable ImportResult.
ItemType ID Success DetailsList -------- -- ------- ----------- OSSetting Local User True {Local User, Loc... OSSetting Local Group True {Local Group, Lo... WindowsFeature DHCP True {}
Cada línea del ejemplo anterior es un resultado de migración para un elemento que fue migrado mediante el cmdlet Import-SmigServerSetting. Los nombres de los encabezados de columna son propiedades de objetos de MigrationResult. Puede incorporar estas propiedades a otro comando para devolver más detalles sobre los objetos de resultados, como se muestra en los ejemplos del paso 3 en adelante.
Para mostrar una propiedad específica para todos los objetos de resutados de la lista, escriba un comando con el siguiente formato y presione Entrar.
$<NombreDeVariable>| Select-Object -ExpandProperty <NombreDePropiedad>
A continuación se muestra un ejemplo.
$importResult | Select-Object -ExpandProperty DetailsList
Puede ejecutar consultas más avanzadas para analizar los objetos de resultados mediante los cmdlets de Windows PowerShell. A continuación se muestran algunos ejemplos.
- El siguiente comando devuelve solo aquellos detalles de los objetos resulatdos que tienen el identificador Local User.
$ImportResult | Where-Object { $_.ID -eq "Local User" } | Select-Object -ExpandProperty DetailsList
- El siguiente comando devuelve aquellos detalles de los objetos resultados con un identificador de Local User que tienen una gravedad de mensaje igual a Warning.
$ImportResult | Where-Object { $_.ID -eq "Local User" } | Select-Object -ExpandProperty DetailsList | ForEach-Object { if ($_.Severity -eq "Warning") {$_} }
- El siguiente comando devuelve aquellos detalles de los objetos resultados con un identificador de Local User que también tienen el título Remote Desktop Users.
$ImportResult | Where-Object { $_.ID -eq "Local Group" } | Select-Object -ExpandProperty DetailsList | ForEach-Object { if ($_.Title -eq "Remote Desktop Users") {$_} }
- El siguiente comando devuelve solo aquellos detalles de los objetos resulatdos que tienen el identificador Local User.
Más información sobre resultados de consulta
Para obtener más información acerca de los cmdlets utilizados en los ejemplos anteriores, vea los siguientes recursos adicionales.
Where-Object en el sitio web del Centro de scripts de Microsoft (https://go.microsoft.com/fwlink/?LinkId=134853).Select-Object en el sitio web del Centro de scripts de Microsoft (https://go.microsoft.com/fwlink/?LinkId=134858).ForEach-Object en el sitio web del Centro de scripts de Microsoft (https://go.microsoft.com/fwlink/?LinkId=134860)
Para obtener más información acerca de las técnicas de scripting de Windows PowerShell, vea el tema acerca de las