UIP RPA remoto

Sintaxis y opciones para `uip rpa remoto`, que configura y controla un robot desatendido de Orchestrator remoto: configuración de destino, sesiones de automatización de IU, ejecución de procesos y transferencia de archivos.

uip rpa remote opera en un robot desatendido de Orchestrator remoto: configura a qué máquina/robot/runtime de destino, inicia o detiene una sesión de diseño de automatización de IU remota en él, ejecuta comandos de shell en él y transfiere archivos hacia/desde él. Una vez configurados, uip rpa run --remote y debug start --remote enrutan la ejecución a esa máquina en lugar de ejecutarse localmente.

Requiere el inicio de sesión de Orchestrator (uip login) para cada verbo.

Sinopsis

uip rpa remote configure --machine <name> [--folder-path <path>] [--robot <name>] [--runtime <name>] [--live-authoring | --remote-run-only]
uip rpa remote status
uip rpa remote start
uip rpa remote stop
uip rpa remote echo --message <text>
uip rpa remote exec --command <cmd> [--package-id <id> --package-version <v>] [--working-directory <dir>] [--timeout <seconds>]
uip rpa remote upload-file --local-path <path> --remote-path <path>
uip rpa remote download-file --remote-path <path> --local-path <path>

configuración remota de uip rpa

Resuelve y almacena el destino de depuración remota (carpeta → robot → máquina → runtime) e inicia la sesión de diseño de automatización de IU remota en él. remote stop desactiva la sesión.

Opciones

Largo	Valor	Obligatorio	Descripción
--machine <name>	String	Sí	Nombre de la máquina de Orchestrator en la que ejecutar el Unattended Robot.
--folder-path <path>	String	No	Carpeta de Orchestrator totalmente calificada a la que pertenece el robot/máquina (por ejemplo Shared/Finance): el robot, la máquina y el runtime se resuelven en él. El valor predeterminado es la carpeta actual del backend.
--robot <name>	String	No	Cuenta de robot/usuario como para ejecutar. Se establece de forma predeterminada en la identidad predeterminada de la máquina.
--runtime <name>	String	No	Nombre del runtime conectado (host/sesión). Se ignora para máquinas sin servidor; configúralo para que se dirija a una sesión conectada específica en una máquina clásica.
--live-authoring	Marca	No	Usa el destino para la creación en vivo: un trabajo de sesión remota de larga duración sirve para cada comando remoto, sesión de ejecución y depuración; la sesión de diseño de automatización de IU remota está disponible y la pantalla remota se transmite. Mutuamente exclusivo con --remote-run-only. Requerido antes de que remote echo funcione.
--remote-run-only	Marca	No	Usa el destino solo para ejecuciones remotas: una sesión de ejecución o depuración es su propio trabajo de Orchestrator, sin sesión de automatización de IU remota. Este es el valor predeterminado para un destino que nunca ha tenido un modo almacenado. Mutuamente exclusivo con --live-authoring.

Pasar tanto --live-authoring como --remote-run-only falla en el lado del cliente: son los dos modos de una conexión; pasar como máximo uno. Pasar ninguno deja el modo almacenado sin cambios.

Ejemplo

uip rpa remote configure --machine BotMachine --folder-path "Shared/Finance"

Forma de datos (--json de salida)

Transferencia sin procesar de la carga útil { success, ...resolved-config } del backend: incluye la carpeta/robot/máquina/runtime resueltos una vez coincidentes.

estado remoto de uip rpa

Muestra la conexión remota configurada actualmente para el tenant que ha iniciado sesión, como se ha resuelto en Orchestrator. Solo lectura: no cambia ni inicia nada. Sin opciones.

Ejemplo

uip rpa remote status

inicio remoto de uip rpa

Iniciar automatización de IU remota: configura una sesión de experiencia de diseño de UIA en el agente remoto configurado, de modo que los comandos uip rpa uia con --remote controlen esa máquina. Falla si no se configura ningún destino (remote configure primero). Iniciar una sesión que ya se está ejecutando no es una operación; reconfigurarlo a un destino diferente lo reinicia. Sin opciones.

Ejemplo

uip rpa remote start

parada remota de uip rpa

Desactiva la sesión de UIA remota actual y libera el agente. Idempotente: tiene éxito incluso cuando no se está ejecutando ninguna sesión o el destino ya no está configurado. Una llamada posterior uia --remote inicia una nueva sesión automáticamente. Sin opciones.

Ejemplo

uip rpa remote stop

eco remoto rpa de uip

Realiza un mensaje de ida y vuelta del AgenteDeSesiónRemota que se ejecuta en el agente remoto configurado e imprime la respuesta: una comprobación de conectividad. Solo creación en vivo (remote configure --live-authoring); Solo ejecución remota no tiene agente para responder. Inicia el agente en el primer uso; cada eco viaja en su propio canal privado, por lo que las personas que llaman simultáneamente solo ven su propia respuesta.

Opciones

Largo	Valor	Obligatorio	Descripción
--message <text>	String	Sí	Envía un mensaje de texto con los ecos de RemoteSessionAgent: útil para distinguir las respuestas de las personas que llaman simultáneamente.

Ejemplo

uip rpa remote echo --message "ping"

ejecución remota de uip rpa

Ejecuta un comando de shell en el agente remoto configurado (cmd.exe /c en Windows, /bin/sh -c de lo contrario), transmitiendo la salida en vivo. No hay modo local: este siempre se ejecuta en la máquina remota.

Opciones

Largo	Valor	Obligatorio	Descripción
--command <cmd>	String	Sí	Línea de comandos del shell para ejecutar de forma remota (p. ej. dir, ls -la). Cuando se restaura un paquete (ver más abajo), puede ser una ruta relativa a la carpeta del paquete.
--package-id <id>	String	condicionalmente	Paquete NuGet para restaurar en la máquina remota antes de ejecutar el comando. Requiere --package-version juntos.
--package-version <v>	String	condicionalmente	Versión de --package-id para restaurar. Obligatorio cuando se establece --package-id: pasar uno sin el otro falla en el lado del cliente.
--working-directory <dir>	String	No	Directorio de trabajo para el comando. El valor predeterminado es la carpeta del paquete restaurado cuando se restaura un paquete; de lo contrario, el directorio actual de la máquina remota.
--timeout <seconds>	Número	No	Cancela el comando después de estos segundos. Omitir para que no haya tiempo de espera.

Ejemplo

uip rpa remote exec --command "dir" --timeout 30

UIP RPA: carga remota de archivos

Carga un archivo local al agente remoto configurado, transferido a través de un depósito de almacenamiento temporal de Orchestrator (creado y eliminado automáticamente).

Opciones

Largo	Valor	Obligatorio	Descripción
--local-path <path>	String	Sí	Ruta al archivo local que se va a cargar.
--remote-path <path>	String	Sí	Ruta de destino en la máquina remota. Se crean los directorios principales.

Ejemplo

uip rpa remote upload-file --local-path ./data.csv --remote-path "C:\Bots\data.csv"

UIP RPA Remote Download-File

Descarga un archivo del agente remoto configurado a una ruta local, transferido a través de un depósito de almacenamiento temporal de Orchestrator.

Opciones

Largo	Valor	Obligatorio	Descripción
--remote-path <path>	String	Sí	Ruta del archivo en la máquina remota que se va a descargar.
--local-path <path>	String	Sí	Ruta de destino localmente. Se crean los directorios principales.

Ejemplo

uip rpa remote download-file --remote-path "C:\Bots\output.log" --local-path ./output.log

Relacionado

• uip rpa run/debug — el marcador --remote que configura el destino de este grupo.
• uip rpa uia : controlado de forma remota una vez que remote start está activo.

Ver también

• Descripción general de la herramienta RPA
• Opciones globales
• Códigos de salida