Sintaxis de ScanState
El comando ScanState se usa con la Herramienta de migración de estado de usuario (USMT) 5.0 para examinar el equipo de origen, recopilar los archivos y la configuración, y crear un almacén.
En este tema
Antes de comenzar
Sintaxis
Opciones de almacenamiento
Opciones de reglas de migración
Opciones de supervisión
Opciones de usuario
Opciones de archivo cifrado
Opciones de línea de comandos no compatibles
Antes de comenzar
Antes de ejecutar el comando ScanState, ten en cuenta lo siguiente:
Para asegurarte de migrar toda la configuración del sistema operativo, en la mayoría de los casos debes ejecutar los comandos ScanState en modo de administrador desde una cuenta con credenciales administrativas.
Si cifras el almacén de migración, deberás escribir una clave de cifrado o una ruta de acceso a un archivo que contenga la clave de cifrado. Asegúrate de anotar la clave o la ubicación del archivo de clave, porque esta información no se conserva en ninguna parte del almacén de migración. Necesitarás esta información cuando ejecutes el comando LoadState para descifrar el almacén de migración, o si necesitas ejecutar la utilidad de recuperación. Si falta una clave o un archivo de clave, o es incorrecto, se generará un mensaje de error.
Para obtener información acerca de los requisitos de software para ejecutar el comando ScanState, consulta Requisitos de USMT.
Importante
Windows XP y Windows Vista® son compatibles solo como sistemas operativos en el equipo de origen.
A menos que se especifique lo contrario, puedes usar cada opción una sola vez al ejecutar una herramienta en la línea de comandos.
Puedes recopilar cuentas de dominio sin que el equipo de origen tenga acceso al controlador de dominio. Esta funcionalidad se encuentra disponible sin ninguna configuración adicional.
La tabla Opciones de línea de comandos no compatibles muestra las opciones que se pueden usar juntas y las opciones de línea de comandos que no son compatibles.
La ubicación del directorio donde se guarda el almacén de migración se excluirá del análisis. Por ejemplo, si guardas el almacén de migración en la raíz de la unidad D, esta unidad y todos sus subdirectorios se excluirán del análisis.
Sintaxis
En esta sección se explica la sintaxis y el uso de las opciones de línea de comandos de ScanState. Las opciones se pueden especificar en cualquier orden. Si la opción contiene un parámetro, puedes usar un carácter de dos puntos o un separador de espacio.
La sintaxis del comando ScanState es la siguiente:
scanstate [StorePath] [/i:[Path\]FileName] [/o] [/v:VerbosityLevel] [/nocompress] [/localonly] [/encrypt /key:KeyString|/keyfile:[Path\]FileName] [/l:[Path\]FileName] [/progress:[Path\]FileName] [/r:TimesToRetry] [/w:SecondsBeforeRetry] [/c] [/p] [/all] [/ui:[DomainName|ComputerName\]UserName] [/ue:[DomainName|ComputerName\]UserName] [/uel:NumberOfDays|YYYY/MM/DD|0] [/efs:abort|skip|decryptcopy|copyraw] [/genconfig:[Path\]FileName[/config:[Path\]FileName] [/?|help]
Por ejemplo:
Para crear un archivo Config.xml en el directorio actual, usa:
scanstate /i:migapp.xml /i:migdocs.xml /genconfig:config.xml /v:13
Para crear un almacén cifrado con el archivo Config.xml y los archivos .xml de migración predeterminados, usa:
scanstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /o /config:config.xml /v:13 /encrypt /key:"mykey"
Opciones de almacenamiento
Opción de línea de comandos | Descripción |
---|---|
StorePath |
Indica una carpeta donde se guardarán los archivos y la configuración. Ten en cuenta que StorePath no puede ser c:\. Debes especificar la opción StorePath en el comando ScanState, excepto cuando se usa la opción /genconfig. No puedes especificar más de una ubicación para StorePath. |
/o |
Se requiere para sobrescribir datos existentes en el almacén de migración o en el archivo Config.xml. Si no se especifica, el comando ScanState generará un error si el almacén de migración ya contiene datos. No puedes usar esta opción más de una vez en una línea de comandos. |
/vsc |
Esta opción permite al servicio de instantáneas de volumen migrar los archivos que están bloqueados o en uso. Esta opción de línea de comandos elimina la mayoría de los errores de bloqueo de archivos que generalmente encuentra la sección <ErrorControl>. Esta opción se puede usar solamente con el archivo ejecutable ScanState y no se puede combinar con la opción /hardlink. |
/hardlink |
Permite la creación de un almacén de migración de vínculo físico en la ubicación especificada. La opción /nocompress se debe especificar con la opción /hardlink. |
/encrypt [{/key:<KeyString> | /keyfile:<file>]} |
Cifra el almacén con la clave especificada. El cifrado está deshabilitado de forma predeterminada. Con esta opción, deberás especificar la clave de cifrado de una de las siguientes maneras:
Te recomendamos que KeyString tenga al menos ocho caracteres, pero no puede superar los 256 caracteres. Las opciones /key y /keyfile no se pueden usar en la misma línea de comandos. Las opciones /encrypt y /nocompress no se pueden usar en la misma línea de comandos. > [!IMPORTANT] > Debes tener cuidado con esta opción, ya que cualquiera que tenga acceso al script de la línea de comandos ScanState también tendrá acceso a la clave de cifrado. >En el siguiente ejemplo se muestra el comando ScanState y la opción /key:
|
/encrypt:<seguridadCifrado> |
La opción /encrypt acepta un parámetro de línea de comandos para definir la seguridad del cifrado que se usará para el cifrado del almacén de migración. Para obtener más información acerca de los algoritmos de cifrado compatibles, consulta Cifrado del almacén de migración. |
/nocompress |
Deshabilita la compresión de datos y guarda los archivos en una carpeta oculta denominada "File" en StorePath\USMT. La compresión está habilitada de manera predeterminada. Al combinar la opción /nocompress con la opción /hardlink se genera un almacén de migración de vínculo físico. Puedes usar el almacén sin comprimir para ver lo que almacenó USMT, solucionar un problema o ejecutar una utilidad antivirus en los archivos. Solo debes usar esta opción en entornos de prueba; te recomendamos usar un almacén comprimido durante la migración real, a menos que estés combinando la opción /nocompress con la opción /hardlink. Las opciones /nocompress y /encrypt no se pueden usar juntas en una instrucción en la línea de comandos. Sin embargo, si eliges migrar un almacén sin comprimir, el comando LoadState migrará cada archivo directamente desde el almacén a la ubicación correcta en el equipo de destino, sin una ubicación temporal. Por ejemplo:
|
Ejecutar el comando ScanState en un sistema de Windows sin conexión
Puedes ejecutar el comando ScanState en Windows PE. Además, USMT admite migraciones de instalaciones anteriores de Windows incluidas en los directorios Windows.old. El directorio sin conexión puede ser un directorio de Windows cuando ejecutas el comando ScanState en Windows PE o un directorio Windows.old cuando ejecutas el comando ScanState en Windows.
Ejecutar el comando ScanState en una imagen de Windows sin conexión ofrece beneficios como los siguientes:
Rendimiento mejorado.
Dado que Windows PE es un sistema operativo dinámico, hay menos servicios en ejecución. En este entorno, el comando ScanState tiene más acceso a los recursos de hardware locales, lo que le permite a ScanState realizar operaciones de migración más rápidamente.
Proceso de implementación integral simplificado.
Los datos de migración de Windows.old simplifican el proceso de implementación integral, ya que permiten que el proceso de migración se produzca después de la instalación del nuevo sistema operativo.
Éxito de migración mejorado.
La tasa de éxito aumenta gracias a que los archivos no se bloquearán para la edición cuando están sin conexión, y porque Windows PE proporciona acceso de administrador a los archivos en el sistema de archivos de Windows sin conexión, lo que elimina la necesidad de acceso a nivel de administrador en el sistema en línea.
Capacidad de recuperar un equipo que no se puede arrancar.
Es posible recuperar y migrar datos desde un equipo que no se puede arrancar.
Opciones de migración sin conexión
Opción de línea de comandos | Definición |
---|---|
/offline: "ruta a un archivo offline.xml" |
Esta opción se usa para definir una ruta a un archivo .xml sin conexión que puede especificar otras opciones de migración sin conexión, por ejemplo, un directorio de Windows sin conexión o cualquier redireccionamiento de dominio o carpeta necesario en la migración. |
/offlinewindir: "ruta a un directorio de Windows" |
Esta opción especifica el directorio de Windows sin conexión en el que el comando ScanState recopila el estado de usuario. El directorio sin conexión puede ser Windows.old cuando ejecutas el comando ScanState en Windows o un directorio de Windows cuando ejecutas el comando ScanState en Windows PE. |
/offlinewinold: "directorio Windows.old" |
Esta opción de la línea de comandos habilita el modo de migración sin conexión e inicia la migración desde la ubicación especificada. Solo la puedes usar en escenarios de migración de Windows.old en los que la migración se realiza desde un directorio Windows.old. |
Opciones de reglas de migración
USMT ofrece las siguientes opciones para especificar los archivos que quieres migrar.
Opción de línea de comandos | Descripción | ||||||||
---|---|---|---|---|---|---|---|---|---|
/i:[Path\]FileName |
(Incluir) Especifica un archivo .xml que contiene reglas que definen el usuario, la aplicación o el estado del sistema que se va a migrar. Puedes especificar esta opción varias veces para incluir todos los archivos .xml (MigApp.xml, MigDocs.xml y cualquier archivo .xml personalizado que crees). Path puede ser una ruta de acceso relativa o completa. Si no especificas la variable Path, FileName debe estar ubicado en el directorio actual. Para obtener más información acerca de los archivos que hay que especificar, consulta la sección sobre archivos XML del tema Preguntas más frecuentes. |
||||||||
/genconfig:[Path\]FileName |
(Genera Config.xml) Genera el archivo Config.xml opcional, pero no crea un almacén de migración. Para asegurarte de que este archivo contenga todos los componentes, aplicaciones y configuraciones que pueden migrarse, debes crear este archivo en un equipo de origen que contenga todos los componentes, aplicaciones y configuraciones que estarán presentes en los equipos de destino. Además, debes especificar los otros archivos .xml de migración con la opción /i cuando especifiques esta opción. Después de crear este archivo, deberás usarlo con el comando ScanState usando la opción /config. Las únicas opciones que puedes especificar con esta opción son /i, /v y /l. No puedes especificar StorePath, porque la opción /genconfig no crea un almacén. Path puede ser una ruta de acceso relativa o completa. Si no especificas la variable Path, entonces FileName se creará en el directorio actual. Ejemplos:
|
||||||||
/config:[Path\]FileName |
Especifica el archivo Config.xml que debe usar el comando ScanState para crear el almacén. No puedes usar esta opción más de una vez en la línea de comandos. Path puede ser una ruta de acceso relativa o completa. Si no especificas la variable Path, FileName debe estar ubicado en el directorio actual. En el siguiente ejemplo se crea un almacén con los archivos Config.xml, MigDocs.xml y MigApp.xml:
En el siguiente ejemplo se migran los archivos y la configuración al equipo de destino con los archivos Config.xml, MigDocs.xml y MigApp.xml:
|
||||||||
/auto: ruta a los archivos de script |
Esta opción te permite especificar la ubicación de los archivos .xml predeterminados y después iniciar la migración. Si no se especifica ninguna ruta de acceso, USMT utilizará el directorio donde se encuentran los binarios de USMT. La opción /auto tiene el mismo efecto que usar las siguientes opciones: /i:MigDocs.xml/i:MigApp.xml /v:5. |
||||||||
/genmigxml: ruta a un archivo |
Esta opción especifica que el comando ScanState debe usar el buscador de documentos para crear y exportar un archivo .xml que define cómo migrar todos los archivos en el equipo en el que se está ejecutando el comando ScanState. |
||||||||
/localonly |
Migra solo los archivos almacenados en el equipo local, independientemente de las reglas en los archivos .xml que especifiques en la línea de comandos. Debes usar esta opción cuando quieras excluir los datos de unidades extraíbles en el equipo de origen, como unidades flash USB (UFD), algunas unidades de disco duro externo, etc., y cuando haya unidades de red asignadas en el equipo de origen. Si no se especifica la opción /localonly, el comando ScanState copiará archivos de estas unidades extraíbles o de red en el almacén. /localonly excluirá todo lo que el sistema operativo no considere como una unidad fija. En algunos casos, las unidades de disco duro externo de gran tamaño se consideran unidades fijas. Estas unidades se pueden excluir explícitamente de la migración con un archivo .xml personalizado. Para obtener más información acerca de cómo excluir todos los archivos en una unidad específica, consulta el tema sobre el Excluir archivos y configuraciones. La opción de línea de comandos /localonly incluye datos en la migración, o los excluye de ella, según se identifica en la siguiente tabla:
|
Opciones de supervisión
USMT proporciona varias opciones que puedes usar para analizar los problemas que se producen durante la migración.
Nota
El registro de ScanState se crea de forma predeterminada, pero puedes especificar el nombre y la ubicación del registro con la opción /l.
Opción de línea de comandos | Descripción | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
/listfiles:<FileName> |
Puedes usar la opción de línea de comandos /listfiles con el comando ScanState para generar un archivo de texto que muestre todos los archivos incluidos en la migración. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
/l:[Path\]FileName |
Especifica la ubicación y el nombre del registro de ScanState. No puedes almacenar los archivos de registro en StorePath. Path puede ser una ruta de acceso relativa o completa. Si no especificas la variable Path, el registro se creará en el directorio actual. Puedes usar la opción /v para ajustar la cantidad de salida. Si ejecutas los comandos ScanState o LoadState desde un recurso compartido de red, debes especificar esta opción o, de lo contrario, USMT no se ejecutará correctamente y generará un error que indica que USMT no pudo crear los archivos de registro. Para solucionar este problema, usa la opción /l:scan.log. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
/v: <VerbosityLevel> |
(Verbosity) Permite la salida detallada en el archivo de registro de ScanState. El valor predeterminado es 0. Puedes establecer VerbosityLevel en uno de los siguientes niveles:
Opciones de usuarioDe forma predeterminada, se migran todos los usuarios. El único modo de especificar qué usuarios se deben incluir o excluir es usar las siguientes opciones. No puedes excluir usuarios en los archivos .xml de migración o mediante el archivo Config.xml. Para obtener más información, consulta Identificar usuarios y Migrar cuentas de usuario.
Cómo usar /ui y /ueLos siguientes ejemplos se aplican a las opciones /ui y /ue. Puedes reemplazar la opción /ue por la opción /ui para incluir, en lugar de excluir, los usuarios especificados.
Uso conjunto de las opcionesPuede usar conjuntamente las opciones /uel, /ue y /ui para migrar solo los usuarios que quieras migrar. La opción /ui tiene prioridad sobre las opciones /ue y /uel. Si se especifica un usuario para incluirlo con la opción /ui, y también se especifica para excluirlo con las opciones /ue o /uel, el usuario se incluirá en la migración. Por ejemplo, si especificas La opción /uel tiene prioridad sobre la opción /ue. Si un usuario ha iniciado sesión en el período de tiempo especificado establecido con la opción /uel, el perfil de ese usuario se migrará aunque se excluya con la opción /ue. Por ejemplo, si especificas
Opciones de archivo cifradoPuedes usar las siguientes opciones para migrar archivos cifrados. De forma predeterminada, en todos los casos USMT genera un error si se encuentra un archivo cifrado, a menos que especifiques una opción /efs. Para migrar archivos cifrados, debes cambiar el comportamiento predeterminado. Para obtener más información, consulta Migrar archivos y certificados EFS. Nota Los certificados EFS se migrarán automáticamente al migrar a Windows Vista, Windows 7 o Windows 8. Por lo tanto, debes especificar la opción /efs:copyraw con el comando ScanState para migrar los archivos cifrados. Advertencia Ten cuidado al migrar archivos cifrados. Si migras un archivo cifrado sin migrar también el certificado, los usuarios finales no podrán acceder al archivo después de la migración.
Opciones de línea de comandos no compatiblesEn la siguiente tabla se indican las opciones de línea de comandos que no son compatibles con el comando ScanState. Si la entrada de la tabla para una combinación en particular está en blanco, las opciones son compatibles y puedes usarlas conjuntamente. El símbolo X significa que las opciones no son compatibles. Por ejemplo, no puedes usar la opción /nocompress con la opción /encrypt.
Nota Debes especificar la opción /key o /keyfile con la opción /encrypt. Consulte tambiénOtros recursos |