G.2 Utilidad del agente de Migrate para Windows

G.2.1 Descarga e instalación del agente de Migrate en una carga de trabajo Windows de origen

Para descargar e instalar la utilidad del agente de Migrate para Windows en la carga de trabajo de origen:

Entre en el equipo Windows de origen como usuario administrador.
En un navegador Web, lance la interfaz Web de PlateSpin Migrate y entre.
Haga clic en la pestaña Downloads (Descargas).
Haga clic en el enlace de la aplicación del agente de Migrate para la plataforma de destino Windows y, a continuación, guarde el archivo MigrateAgent.cli.exe comprimido.
Extraiga el contenido del archivo para acceder al archivo ejecutable.
(Opcional) Para ver la ayuda del agente de Migrate, introduzca:
```
MigrateAgent.cli.exe -h
```

G.2.2 Comandos del agente de Migrate para Windows

La sintaxis para ejecutar la utilidad del agente de Migrate para Windows es:

MigrateAgent.cli.exe {command} [command_option] [/psserver=%IP%]

En la Tabla G-1 se describen los comandos, las opciones de los comandos y los parámetros disponibles para el comando MigrateAgent.cli.exe.

Tabla G-1 Comandos, opciones de comandos y parámetros de la utilidad del agente de Migrate para Windows

Uso	Descripción
Comandos
h \| ? \| help	Muestra el uso y las opciones del comando.
logs \| view-logs	Abre el directorio de registro de la aplicación.
reg \| register /reg /psserver=%IP% /username=<nombreusuario> [[ /password=<contraseña>] \| [/pwdfile=<vía-a-archivo-de-contraseña>]] Si no especifica la contraseña o una vía a un archivo que contenga la contraseña, se le pedirá la contraseña. La contraseña se oculta a medida que la escribe y no aparece en la lista de procesos. Ejemplo: MigrateAgent.cli.exe /register /psserver=10.10.10.101 /username=jsmith /password=jspwd	Registra este equipo como una carga de trabajo en el servidor especificado. También comprueba si hay actualizaciones del controlador en el servidor de PlateSpin especificado. Permite añadir cargas de trabajo que no se pueden descubrir. Las cargas de trabajo registradas difieren de las cargas de trabajo descubiertas de las siguientes maneras: Las cargas de trabajo de origen registradas no almacenan las credenciales de origen. Debe utilizar el agente de Migrate para instalar, actualizar y eliminar controladores de transferencia basada en bloques (BBT) de las cargas de trabajo de origen registradas. Después de suprimir el contrato de una carga de trabajo de origen registrada, debe eliminar manualmente el controlador OFX de la carga de trabajo. Para eliminar el controlador OFX de la carga de trabajo, consulte este artículo de la base de conocimientos.
status /status [/psserver=%IP%]	Muestra el estado de instalación de los controladores de PlateSpin en esta carga de trabajo. Si especifica el servidor de PlateSpin, se comprobará si hay actualizaciones del controlador en el servidor.
din \| driver-install /din [/psserver=%IP%]	Instala los controladores de PlateSpin. NOTA:Antes de instalar controladores de transferencia basada en bloques en las cargas de trabajo Windows de origen, asegúrese de que ha aplicado las actualizaciones más recientes de Windows en la carga de trabajo. Si especifica el servidor de PlateSpin, se comprobará si hay actualizaciones del controlador en el servidor.
dup \| driver-upgrade /dup [/psserver=%IP%]	Actualiza los controladores de PlateSpin. Si especifica el servidor de PlateSpin, se comprobará si hay actualizaciones del controlador en el servidor.
dun \| driver-uninstall [/dun /psserver=%IP%]	Desinstala los controladores de PlateSpin.
con \| config /con /setting=<nombre_valor>:<valor> Ejemplo: migrateagent.cli.exe /config /setting=psserver:10.10.10.202	Especifica el nombre del ajuste y su valor, que deben cambiarse en el archivo de configuración de esta carga de trabajo. La opción psserver detiene el servicio del controlador OFX (ofxcontroller), modifica el archivo OfxController.exe.config con la nueva dirección IP y reinicia el servicio. Si modifica la dirección IP pública del servidor de PlateSpin, debe ejecutar este comando en cada una de las cargas de trabajo de origen que se configuren para el servidor.
Conmutador
/psserver=%IP%	Especifica la dirección IPv4 del servidor de PlateSpin. Descarga los controladores de transferencia basados en bloques del servidor especificado cuando se invocan las opciones status, driver-install o driver-upgrade.
Opciones de comando
username /username=valor	Especifica el nombre de usuario del servidor de PlateSpin para un usuario administrador con derechos para añadir una carga de trabajo.
password \| pwd \| p /password= valor	Especifica la contraseña para el nombre de usuario especificado del servidor de PlateSpin. Si excluye la contraseña de la línea de comandos, el guion se la solicitará. La contraseña se oculta a medida que la escribe y no aparece en la lista de procesos. No combine esta opción con pwdfile.
pwdfile \| pf /pwdfile=valor	Especifica la vía a un archivo que contiene la contraseña para el nombre de usuario del servidor de PlateSpin especificado. No combine esta opción con password.
setting /setting=<nombre_valor>:<valor>	Especifica el nombre del ajuste y el valor del ajuste de configuración que debe modificarse. Los nombres de ajuste admitidos son: psserver altAddress heartbeat

Uso

Descripción

Comandos

h | ? | help

Muestra el uso y las opciones del comando.

logs | view-logs

Abre el directorio de registro de la aplicación.

reg | register

/reg /psserver=%IP% /username=<nombreusuario> [[ /password=<contraseña>] | [/pwdfile=<vía-a-archivo-de-contraseña>]]

Si no especifica la contraseña o una vía a un archivo que contenga la contraseña, se le pedirá la contraseña. La contraseña se oculta a medida que la escribe y no aparece en la lista de procesos.

Ejemplo:

MigrateAgent.cli.exe /register /psserver=10.10.10.101 /username=jsmith /password=jspwd

Registra este equipo como una carga de trabajo en el servidor especificado. También comprueba si hay actualizaciones del controlador en el servidor de PlateSpin especificado.

Permite añadir cargas de trabajo que no se pueden descubrir. Las cargas de trabajo registradas difieren de las cargas de trabajo descubiertas de las siguientes maneras:

Las cargas de trabajo de origen registradas no almacenan las credenciales de origen.
Debe utilizar el agente de Migrate para instalar, actualizar y eliminar controladores de transferencia basada en bloques (BBT) de las cargas de trabajo de origen registradas.
Después de suprimir el contrato de una carga de trabajo de origen registrada, debe eliminar manualmente el controlador OFX de la carga de trabajo. Para eliminar el controlador OFX de la carga de trabajo, consulte este artículo de la base de conocimientos.

status

/status [/psserver=%IP%]

Muestra el estado de instalación de los controladores de PlateSpin en esta carga de trabajo.

Si especifica el servidor de PlateSpin, se comprobará si hay actualizaciones del controlador en el servidor.

din | driver-install

/din [/psserver=%IP%]

Instala los controladores de PlateSpin.

NOTA:Antes de instalar controladores de transferencia basada en bloques en las cargas de trabajo Windows de origen, asegúrese de que ha aplicado las actualizaciones más recientes de Windows en la carga de trabajo.

Si especifica el servidor de PlateSpin, se comprobará si hay actualizaciones del controlador en el servidor.

dup | driver-upgrade

/dup [/psserver=%IP%]

Actualiza los controladores de PlateSpin.

Si especifica el servidor de PlateSpin, se comprobará si hay actualizaciones del controlador en el servidor.

dun | driver-uninstall

[/dun /psserver=%IP%]

Desinstala los controladores de PlateSpin.

con | config

/con /setting=<nombre_valor>:<valor>

Ejemplo:

migrateagent.cli.exe /config /setting=psserver:10.10.10.202

Especifica el nombre del ajuste y su valor, que deben cambiarse en el archivo de configuración de esta carga de trabajo.

La opción psserver detiene el servicio del controlador OFX (ofxcontroller), modifica el archivo OfxController.exe.config con la nueva dirección IP y reinicia el servicio. Si modifica la dirección IP pública del servidor de PlateSpin, debe ejecutar este comando en cada una de las cargas de trabajo de origen que se configuren para el servidor.

Conmutador

/psserver=%IP%

Especifica la dirección IPv4 del servidor de PlateSpin.

Descarga los controladores de transferencia basados en bloques del servidor especificado cuando se invocan las opciones status, driver-install o driver-upgrade.

Opciones de comando

username

/username=valor

Especifica el nombre de usuario del servidor de PlateSpin para un usuario administrador con derechos para añadir una carga de trabajo.

password | pwd | p

/password= valor

Especifica la contraseña para el nombre de usuario especificado del servidor de PlateSpin.

Si excluye la contraseña de la línea de comandos, el guion se la solicitará. La contraseña se oculta a medida que la escribe y no aparece en la lista de procesos.

No combine esta opción con pwdfile.

pwdfile | pf

/pwdfile=valor

Especifica la vía a un archivo que contiene la contraseña para el nombre de usuario del servidor de PlateSpin especificado.

No combine esta opción con password.

setting

/setting=<nombre_valor>:<valor>

Especifica el nombre del ajuste y el valor del ajuste de configuración que debe modificarse.

Los nombres de ajuste admitidos son:

psserver
altAddress
heartbeat