uip rpa remoto

Sintaxe e opções para "uip rpa Remote", que configura e aciona um Unattended Robot do Orchestrator remoto — configuração de destino, sessões de Automação de Interface Gráfica, execução de processos e transferência de arquivos.

uip rpa remote opera em um Unattended Robot do Orchestrator remoto: configure qual máquina/robô/runtime segmentar, inicie ou interrompa uma sessão de design de Automação de Interface Gráfica remota nele, execute comandos de shell nele e transfira arquivos de/para ele. Após configurados, uip rpa run --remote e debug start --remote roteiam a execução para essa máquina em vez de executar localmente.

Requer login no Orchestrator (uip login) para cada verbo.

Resumo

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>

Configuração remota do uip rpa

Resolva e armazene o destino de depuração remota (pasta → robô → máquina → runtime) e inicie a sessão de design de Automação de Interface Gráfica remota nele. remote stop desativa a sessão.

Opções

Long	Valor	Required	Description
--machine <name>	String	sim	Nome da máquina do Orchestrator para executar o robô não assistido.
--folder-path <path>	String	não	Pasta do Orchestrator totalmente qualificada à qual o robô/máquina pertence (por exemplo Shared/Finance— o robô, a máquina e o runtime são resolvidos dentro dele. O padrão é a pasta atual do back-end.
--robot <name>	String	não	Conta de robô/usuário para executar. O padrão é a identidade padrão da máquina.
--runtime <name>	String	não	Nome do runtime conectado (host/sessão). Ignorado para máquinas sem servidor; defina-o para segmentar uma sessão conectada específica em uma máquina clássica.
--live-authoring	Bandeira	não	Use o destino para criação ao vivo: um trabalho de sessão remota de longa duração serve para cada sessão de comando remoto, execução e depuração; a sessão de design de Automação de Interface Gráfica remota fica disponível e a tela remota é transmitida. mutuamente exclusivo com --remote-run-only. Obrigatório para que remote echo funcione.
--remote-run-only	Bandeira	não	Use o destino apenas para execuções remotas: uma sessão de execução ou depuração é seu próprio trabalho do Orchestrator, sem sessão de Automação de Interface Gráfica remota. Este é o padrão para um destino que nunca teve um modo armazenado. mutuamente exclusivo com --live-authoring.

A passagem de --live-authoring e --remote-run-only falha no lado do cliente — eles são os dois modos de uma conexão; passar no máximo um. Não passar não deixa o modo armazenado inalterado.

Exemplo

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

Formato dos dados (--output json)

Passagem bruta da carga { success, ...resolved-config } do back-end — inclui a pasta/robô/máquina/runtime resolvidos uma vez correspondido.

status remoto do uip rpa

Mostre a conexão remota atualmente configurada para o tenant conectado, conforme resolvida no Orchestrator. SomenteLeitura — não muda nem inicia nada. Sem opções.

Exemplo

uip rpa remote status

Início remoto do uip rpa

Iniciar a Automação de Interface Gráfica remota: configure uma sessão de experiência de design de UIA no agente remoto configurado para que os comandos uip rpa uia com --remote impulsionem essa máquina. A falha se nenhum destino for configurado (remote configure primeiro). Iniciar uma sessão já em execução é um não operacional; a reconfiguração para um destino diferente o reinicia. Sem opções.

Exemplo

uip rpa remote start

parada remota do uip rpa

Desative a sessão de UIA remota atual e libere o agente. Idempotent — é bem-sucedido mesmo quando nenhuma sessão está em execução ou o destino não está mais configurado. Uma uia --remote chamada posterior inicia uma nova sessão automaticamente. Sem opções.

Exemplo

uip rpa remote stop

echo remoto do uip rpa

Faça uma mensagem de ida e volta no RemoteSessionAgent em execução no agente remoto configurado e imprima a resposta — uma verificação de conectividade. Apenas criação ao vivo (remote configure --live-authoring); Somente Execução remota não tem um agente para responder. Inicia o agente no primeiro uso; cada echo vai para seu próprio canal privado, portanto, os chamadores simultâneos só veem sua própria resposta.

Opções

Long	Valor	Required	Description
--message <text>	String	sim	Texto que o RemoteSessionAgent retorna — útil para diferenciar as respostas dos chamadores simultâneos.

Exemplo

uip rpa remote echo --message "ping"

Executor remoto do uip rpa

Execute um comando de shell no agente remoto configurado (cmd.exe /c no Windows, /bin/sh -c caso contrário), transmitindo a saída de volta ao vivo. Não há modo local — sempre é executado na máquina remota.

Opções

Long	Valor	Required	Description
--command <cmd>	String	sim	Linha de comando do shell para executar remotamente (por exemplo dir, ls -la). Quando um pacote é restaurado (veja abaixo), pode ser um caminho relativo à pasta do pacote.
--package-id <id>	String	condicionalmente	NuGet a ser restaurado na máquina remota antes de executar o comando. Requer --package-version juntos.
--package-version <v>	String	condicionalmente	Versão de --package-id a ser restaurada. Obrigatório quando --package-id está definido — passar um sem o outro falha no lado do cliente.
--working-directory <dir>	String	não	Diretório de trabalho para o comando. O padrão é a pasta do pacote restaurada quando um pacote é restaurado; caso contrário, o diretório atual da máquina remota.
--timeout <seconds>	Número	não	Encerre o comando após alguns segundos. Omita sem tempo limite.

Exemplo

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

arquivo de upload remoto do uip rpa

Carregue um arquivo local para o agente remoto configurado, transferido por meio de um bucket de armazenamento temporário do Orchestrator (criado e excluído automaticamente).

Opções

Long	Valor	Required	Description
--local-path <path>	String	sim	Caminho para o arquivo local a ser carregado.
--remote-path <path>	String	sim	Caminho de destino na máquina remota. Diretórios pai são criados.

Exemplo

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

Arquivo de download remoto do uip rpa

Baixe um arquivo do agente remoto configurado para um caminho local, transferido por meio de um bucket de armazenamento temporário do Orchestrator.

Opções

Long	Valor	Required	Description
--remote-path <path>	String	sim	Caminho do arquivo na máquina remota a ser baixada.
--local-path <path>	String	sim	Caminho de destino localmente. Diretórios pai são criados.

Exemplo

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

Relacionado

• uip rpa run/debug — o sinalizador --remote que o destino deste grupo configura.
• uip rpa uia — acionado remotamente quando remote start está ativo.

Veja também

• Visão geral da ferramenta RPA
• Opções globais
• Códigos de saída