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 propiedadTipoDefinició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 propiedadTipoDefinició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 propiedadTipoDefinició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
  1. 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.

  2. 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.

  3. 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
  4. 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") {$_} }

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 posibilidades de Windows PowerShell y las técnicas de scripting (puede estar en inglés) en el sitio web del Centro de scripts de Microsoft (https://go.microsoft.com/fwlink/?LinkId=134862).