rdp-cli · 0.3.1

Referência de comandos do rdp-cli

109 comandos para desktops remotos, aplicativos Linux e Android: conecte, observe, opere, troque arquivos e compartilhe o controle.

Buscar comandos por tarefa

Primeira vez com o rdp-cli? Comece pela instalação e pela primeira conexão. →

connect
Conecta uma sessão persistente RDP, VNC ou Android ADB.
screenshot
Capturar observação PNG consistente
click
Clicar em coordenada remota
type
Digita sem alterar a área de transferência; Android aceita ASCII imprimível, LF e TAB. Use android text para colar Unicode.
files upload
Envia para a raiz de arquivos da sessão e verifica a transferência concluída.
files download
Baixa da unidade RDP ou de uma cópia estável do arquivo Android.
watch
Abrir visualizador humano
list
Listar sessões visíveis

Catálogo verificado na compilação 2026110701 para Windows, macOS e Linux. Confira o executável instalado com --version e --help-json.

Observar, agir e verificar

USER, SESSION, OBSERVATION, X e Y devem ser substituídos. Envie a senha por stdin e feche o fluxo; --password-stdin não abre um prompt interativo. Guarde data.session, leia before.png, escolha coordenadas da imagem e verifique after.png. Enviar a entrada não confirma a conclusão da tarefa.

rdp-cli connect --host desktop.example.net --user USER --password-stdin
rdp-cli screenshot --session SESSION --out before.png
rdp-cli click --session SESSION --desktop --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png

--version informa versão e capacidades; --help-json fornece o catálogo estruturado; COMMAND --help descreve as opções sem iniciar uma sessão.

rdp-cli --version
rdp-cli --help-json
rdp-cli connect --help

JSON e opções comuns

Comandos normais retornam um objeto JSON UTF-8 em stdout: ok: true com data ou ok: false com error. stderr contém diagnósticos. Códigos de saída: 0 sucesso, 1 falha operacional, 2 argumentos inválidos.

A ajuda usa texto. events --follow transmite NDJSON; events sem acompanhamento retorna um resultado JSON com data.events e data.ndjson. No PowerShell 5.1, configure [Console]::OutputEncoding e $OutputEncoding como UTF-8 para texto não ASCII.

data.session
Guarde o ID retornado por connect.
data.observation
Use o token da captura; renove após reconexão ou mudanças de controle e telas.
data.capabilities
Consulte capacidades negociadas antes de arquivos, áudio, área de transferência ou monitores.
data.state / data.remote_outcome
queued, sent, partial, unknown, cancelled e failed descrevem progresso. remote_outcome: not_confirmed ainda exige conferir o resultado.
data.transfer_id
Use com files status ou files cancel; espere um estado final e confira hashes dos arquivos concluídos.
error.code / error.message / error.retryable
Decida pelo código estável. Mensagem e retryable orientam, mas não autorizam repetição sem análise.
data.activity
Atividade atual ou recente, origem humana ou Agent, tempo decorrido e progresso da transferência. Não inclui texto digitado nem conteúdo da área de transferência e não comprova a conclusão da tarefa remota.

Todos os comandos aceitam --request-id e --timeout-ms. Reutilize um ID apenas com o mesmo comando e argumentos dentro da janela de retenção. Um timeout local não prova que nada foi enviado; consulte operations status.

--request-id ID · --timeout-ms MILLISECONDS

Sessões

RDP/VNC exige --host; RDP também exige --user. As portas padrão são 3389 e 5900. Escolha uma fonte de senha quando houver autenticação; --vnc-security none não usa senha. ADB usa --device e --transport, com endereço e porta de conexão Wi-Fi opcionais. --domain, --size e --layout são opções RDP. reconnect mantém o controle pausado; disconnect não encerra a sessão do usuário remoto.

rdp-cli connect#

Conecta uma sessão persistente RDP, VNC ou Android ADB.

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--profile

Perfil de conexão salvo

TextoOpcional
--host

Host RDP/VNC ou endereço Wi-Fi Android explícito.

TextoOpcional
--protocol

Protocolo: RDP, VNC, ADB ou X11; cada um usa um destino explícito e suas próprias regras de autenticação.

Escolha
rdp | vnc | adb | x11
Padrão: rdp
Opcional
--mode

Modo X11: desktop existente ou aplicativo encaminhado.

Escolha
desktop | application
Opcional
--display

Display X11 existente e autorizado; apenas modo desktop.

TextoOpcional
--xauthority

Caminho absoluto de Xauthority remoto existente; apenas desktop.

TextoOpcional
--ssh-known-hosts

Arquivo local known_hosts do OpenSSH; não requer um executável SSH externo.

CaminhoOpcional
--ssh-key

Chave SSH privada local; a entrada de senha fornece sua frase secreta.

CaminhoOpcional
--ssh-host-key

Impressão digital SSH SHA256 verificada de forma independente.

TextoOpcional
--linux-file-root

Diretório SFTP absoluto autorizado; por padrão, um diretório privado de sessão dentro da pasta pessoal SSH.

TextoOpcional
--application

Caminho absoluto de um aplicativo X11 remoto já instalado.

TextoOpcional
--app-args

Matriz JSON de argumentos literais, sem interpretação pelo shell.

TextoOpcional
--device

ID explícito retornado por android devices; obrigatório para ADB.

TextoOpcional
--transport

Transporte USB ou Wi-Fi explícito; obrigatório para ADB.

Escolha
usb | wifi
Opcional
--device-auth-ref

Reutiliza uma identidade salva explicitamente no cofre de credenciais do sistema.

TextoOpcional
--save-device-auth

Salva explicitamente a identidade autorizada com esta referência local.

TextoOpcional
--device-file-root

Diretório Android autorizado; padrão /sdcard/Download/rdp-cli/<session-id>.

CaminhoOpcional
--android-display

Tela principal ou virtual pertencente à sessão

Escolha
main | virtual
Opcional
--android-virtual-size

Tamanho virtual, LARGURAxALTURA

TextoOpcional
--android-virtual-dpi

DPI da tela virtual

Inteiro positivoOpcional
--android-start-app

Aplicativo instalado para iniciar na nova tela virtual

TextoOpcional
--vnc-security

Autenticação VNC; none deve ser escolhido explicitamente

Escolha
vnc-auth | none | x509-plain | ard
Opcional
--vnc-tls-pin

Impressão SHA256 verificada do certificado final para VNC X509Plain.

TextoOpcional
--port

Porta TCP: RDP 3389 ou VNC 5900. android pair usa a porta de pareamento do celular; ADB connect usa outra porta de conexão.

Inteiro positivo
Padrão: RDP 3389 · VNC 5900
Opcional
--user

Conta local ou de domínio; obrigatória para RDP

TextoOpcional
--domain

Domínio do Windows

TextoOpcional
--password

Senha; VNC clássico usa os primeiros 8 bytes UTF-8

TextoOpcional
--password-stdin

Ler a senha da entrada padrão até EOF

SinalizadorOpcional
--cert-policy

Política de certificado RDP, independente do HTTPS Web

Escolha
ignore | strict
Padrão: ignore
Opcional
--tls-profile

modern exige TLS 1.2 e criptografia moderna; legacy permite assinaturas/cifras antigas, incluindo SHA-1 com TLS 1.2, e TLS 1.0 nesta sessão, sem forçar uma versão anterior

Escolha
modern | legacy
Padrão: modern
Opcional
--credential-ref

Referência existente no armazenamento de credenciais

TextoOpcional
--audio-mode

Destino do som RDP: visualizador (client), computador controlado (host) ou desligado (off)

Escolha
client | host | off
Padrão: client
Opcional
--microphone-mode

Origem do microfone RDP: visualizador autorizado (client), auxiliar compatível do computador controlado (host) ou desligado (off)

Escolha
client | host | off
Padrão: client
Opcional
--save-credential

Salvar a senha validada com esta referência

TextoOpcional
--name

Nome legível da sessão

TextoOpcional
--size

Tamanho da área de trabalho WIDTHxHEIGHT

TextoOpcional
--layout

Layout de monitores em JSON ou @file

TextoOpcional
--connect-timeout-ms

Prazo de conexão em milissegundos

Inteiro positivoOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli connect --help

rdp-cli list#

Listar sessões visíveis

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli list --help

rdp-cli status#

Consultar estado da sessão

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli status --help

rdp-cli reconnect#

Reconectar e permanecer pausado

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli reconnect --help

rdp-cli disconnect#

Fecha a conexão remota; RDP não encerra a sessão do usuário Windows.

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli disconnect --help

Visualização e status

watch abre um visualizador humano somente para leitura com --viewer window ou web; comandos do Agent não dependem dele. presence show/hide controla o status local; --floating adiciona controles e --panel abre o painel de sessões no macOS ou Linux. Fechar a observação mantém a conexão.

rdp-cli watch#

Abrir visualizador humano

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--viewer

Implementação do visualizador

Escolha
window | web
Padrão: window
Opcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli watch --help

rdp-cli presence show#

Mostrar status do desktop

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--floating

Exibir também os controles flutuantes opcionais

SinalizadorOpcional
--panel

Abrir também o painel de sessões no macOS ou Linux

SinalizadorOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli presence show --help

rdp-cli presence hide#

Ocultar status sem desconectar

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli presence hide --help

Controle e devolução

pause usa --session ou --all e revoga controle humano. resume devolve ao Agent. control take exige um viewer ID conectado; release pode indicar esse visualizador ou o Agent de destino. Respeite pausas humanas e capture novamente após a devolução.

rdp-cli pause#

Pausar entrada e revogar controle

Escolha exatamente um: --session SESSION ou --all.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli pause --help

rdp-cli resume#

Devolver sessão ao Agent

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli resume --help

rdp-cli control take#

Entregar controle ao visualizador

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--viewer-id

ID do visualizador conectado; titular do controle quando necessário

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli control take --help

rdp-cli control release#

Devolver controle ao Agent

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--viewer-id

ID do visualizador conectado; titular do controle quando necessário

TextoOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--to-agent

Identidade do agente de destino

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli control release --help

Capturas, entrada e área de transferência

screenshot salva PNG com --out e seleciona tela com --monitor. Coordenadas exigem observation e referência à tela ou --desktop, sem misturar. drag usa origem/destino e monitores opcionais. type escolhe --text ou --text-stdin; --sensitive altera o aviso, não a captura. key usa --keys ou --key com --state. A escrita substitui o texto da área de transferência remota.

rdp-cli screenshot#

Capturar observação PNG consistente

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--monitor

ID do monitor; screenshot também aceita all

Texto
Padrão: all
Opcional
--region

Região x,y,width,height em pixels remotos

TextoOpcional
--max-width

Largura máxima da imagem; coordenadas de entrada não mudam

Inteiro positivoOpcional
--since

Referência de comparação de captura anterior

TextoOpcional
--out

Arquivo PNG de destino

CaminhoOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli screenshot --help

rdp-cli move#

Mover ponteiro remoto

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--x

Coordenada x remota

InteiroObrigatória
--y

Coordenada y remota

InteiroObrigatória
--monitor

ID do monitor; screenshot também aceita all

TextoOpcional
--desktop

Usar coordenadas da área de trabalho em vez das locais do monitor

SinalizadorOpcional
--observation

Token de uma captura recente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli move --help

rdp-cli click#

Clicar em coordenada remota

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--x

Coordenada x remota

InteiroObrigatória
--y

Coordenada y remota

InteiroObrigatória
--button

Botão do mouse

Escolha
left | right | middle
Padrão: left
Opcional
--count

Número de cliques

Inteiro positivoOpcional
--monitor

ID do monitor; screenshot também aceita all

TextoOpcional
--desktop

Usar coordenadas da área de trabalho em vez das locais do monitor

SinalizadorOpcional
--observation

Token de uma captura recente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli click --help

rdp-cli scroll#

Rolar em uma coordenada

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--x

Coordenada x remota

InteiroObrigatória
--y

Coordenada y remota

InteiroObrigatória
--delta-x

Unidades horizontais da roda com sinal

InteiroOpcional
--delta-y

Unidades verticais da roda com sinal

InteiroOpcional
--monitor

ID do monitor; screenshot também aceita all

TextoOpcional
--desktop

Usar coordenadas da área de trabalho em vez das locais do monitor

SinalizadorOpcional
--observation

Token de uma captura recente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli scroll --help

rdp-cli drag#

Arrastar entre coordenadas

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--from-x

Coordenada x inicial

InteiroObrigatória
--from-y

Coordenada y inicial

InteiroObrigatória
--to-x

Coordenada x final

InteiroObrigatória
--to-y

Coordenada y final

InteiroObrigatória
--from-monitor

ID do monitor inicial

TextoOpcional
--to-monitor

ID do monitor final

TextoOpcional
--desktop

Usar coordenadas da área de trabalho em vez das locais do monitor

SinalizadorOpcional
--observation

Token de uma captura recente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli drag --help

rdp-cli type#

Digita sem alterar a área de transferência; Android aceita ASCII imprimível, LF e TAB. Use android text para colar Unicode.

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--text

Texto Unicode de entrada ou da área de transferência

TextoOpcional
--text-stdin

Ler o texto de entrada ou da área de transferência até EOF

SinalizadorOpcional
--sensitive

Ocultar texto em eventos observáveis; as capturas continuam mostrando a tela

SinalizadorOpcional
--observation

Token de uma captura recente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli type --help

rdp-cli key#

Enviar combinação ou estado de tecla

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--keys

Combinação como CTRL+S

TextoOpcional
--key

Nome da tecla; android key usa as teclas do sistema listadas.

TextoOpcional
--state

Estado da tecla ou do áudio mudo conforme os valores listados

Escolha
down | up
Opcional
--observation

Token de uma captura recente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli key --help

rdp-cli clipboard get#

Ler área de transferência remota

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli clipboard get --help

rdp-cli clipboard set#

Escrever na área de transferência remota

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--text

Texto Unicode de entrada ou da área de transferência

TextoOpcional
--text-stdin

Ler o texto de entrada ou da área de transferência até EOF

SinalizadorOpcional
--observation

Token de uma captura recente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli clipboard set --help

Arquivos

--path é relativo à unidade RDP, diretório Android ou raiz SFTP X11 autorizados. --local indica um arquivo ou pasta local. A substituição exige --overwrite. Confira o estado e os hashes finais; não repita operações com resultado desconhecido.

rdp-cli files list#

Lista arquivos da unidade RDP ou do diretório Android autorizado.

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--path

Caminho relativo à unidade RDP ou ao diretório Android autorizado.

CaminhoOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli files list --help

rdp-cli files upload#

Envia para a raiz de arquivos da sessão e verifica a transferência concluída.

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--local

Arquivo/diretório local de envio ou destino do download

CaminhoObrigatória
--path

Caminho relativo à unidade RDP ou ao diretório Android autorizado.

CaminhoObrigatória
--overwrite

Permitir substituir um destino existente

SinalizadorOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli files upload --help

rdp-cli files download#

Baixa da unidade RDP ou de uma cópia estável do arquivo Android.

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--path

Caminho relativo à unidade RDP ou ao diretório Android autorizado.

CaminhoObrigatória
--local

Arquivo/diretório local de envio ou destino do download

CaminhoObrigatória
--overwrite

Permitir substituir um destino existente

SinalizadorOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli files download --help

rdp-cli files status#

Consultar transferências

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--transfer-id

ID da transferência; files status sem ele lista as transferências

TextoOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli files status --help

rdp-cli files cancel#

Cancelar transferência

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--transfer-id

ID da transferência; files status sem ele lista as transferências

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli files cancel --help

rdp-cli files cleanup#

Remover conteúdo de troca

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--path

Caminho relativo à unidade RDP ou ao diretório Android autorizado.

CaminhoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli files cleanup --help

Som e microfone

No RDP, --audio-mode client|host|off e --microphone-mode client|host|off escolhem separadamente a reprodução e o microfone de uma nova conexão, sem iniciar gravação. host exige o serviço correspondente no Windows controlado e não está disponível no Linux. X11/VNC não têm canal de áudio do produto.

rdp-cli host-microphone install#

Instalar e iniciar neste PC Windows o auxiliar de microfone do computador controlado

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli host-microphone install --help

rdp-cli host-microphone status#

Verificar se o auxiliar de microfone do computador controlado está instalado neste PC Windows

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli host-microphone status --help

rdp-cli host-microphone uninstall#

Parar e remover deste PC Windows o auxiliar de microfone do computador controlado

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli host-microphone uninstall --help

rdp-cli audio status#

Consultar capacidades de áudio

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli audio status --help

rdp-cli audio mute#

Silenciar ou reativar um visualizador

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--viewer-id

ID do visualizador conectado; titular do controle quando necessário

TextoObrigatória
--state

Estado da tecla ou do áudio mudo conforme os valores listados

Escolha
on | off
Obrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli audio mute --help

rdp-cli audio volume#

Ajustar volume do visualizador

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--viewer-id

ID do visualizador conectado; titular do controle quando necessário

TextoObrigatória
--percent

Ganho de reprodução em porcentagem

Inteiro positivoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli audio volume --help

rdp-cli audio microphone#

Consultar ou parar microfone

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--action

Consultar ou parar o microfone; iniciar exige um visualizador humano

Escolha
status | stop
Padrão: status
Opcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli audio microphone --help

rdp-cli audio android#

Seleciona explicitamente reprodução, microfone do celular ou desligado.

Requer um download atual com suporte a Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) ou Linux (x86_64 / ARM64).

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--source

Áudio do celular: off, output (autorização de compartilhamento do sistema) ou microphone (exige controle e --observation recente).

Escolha
off | output | microphone
Obrigatória
--observation

Token de uma captura recente

TextoOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli audio android --help

rdp-cli audio poll#

Lê uma quantidade limitada de amostras PCM recentes.

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--after

Retorna eventos ou amostras PCM após esta sequência.

Inteiro positivoOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli audio poll --help

Monitores

monitors retorna a topologia. monitors set aceita JSON ou @file; --allow-reconnect permite reconexão se não houver ajuste dinâmico. Confira a nova topologia e faça outra captura. VNC informa o framebuffer, mas rejeita alterações de disposição solicitadas.

rdp-cli monitors#

Consultar topologia negociada

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli monitors --help

rdp-cli monitors set#

Alterar disposição dos monitores

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--layout

Layout de monitores em JSON ou @file

TextoObrigatória
--allow-reconnect

Permitir reconexão se o layout dinâmico não estiver disponível

SinalizadorOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli monitors set --help

Acesso web

web start configura endereço, certificado/chave TLS ou proxy confiável; --ice-server pode repetir. Fora de loopback são necessários LAN/VPN, HTTPS e autorização. access grant exige --permission e --expires-in em segundos. Permissões: session.observe/control, clipboard.read/write, files.read/write, audio.listen/send. Revogar encerra os fluxos associados.

rdp-cli web start#

Iniciar serviço web autorizado

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--listen

Endereço de escuta

TextoOpcional
--tls-cert

Arquivo de certificado HTTPS

CaminhoOpcional
--tls-key

Arquivo da chave privada HTTPS

CaminhoOpcional
--trust-proxy

Confiar no proxy configurado

SinalizadorOpcional
--ice-server

URL STUN/TURN para WebRTC

TextoOpcional · Repetível
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli web start --help

rdp-cli web status#

Consultar serviço web

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli web status --help

rdp-cli web stop#

Interrompe o acesso pelo navegador e mantém as sessões remotas conectadas.

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli web stop --help

rdp-cli access grant#

Criar autorização web limitada

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--permission

Permissão concedida ao token de acesso

TextoObrigatória · Repetível
--expires-in

Validade da autorização em segundos

Inteiro positivoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli access grant --help

rdp-cli access list#

Listar autorizações

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli access list --help

rdp-cli access revoke#

Revogar autorização e fluxos

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--grant-id

Identificador da autorização

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli access revoke --help

Celulares Android

Informe o ID do dispositivo e o transporte usb ou wifi. Detectar não autoriza o celular. A porta de pareamento é diferente da porta de conexão. Envie o código pela entrada padrão e feche o fluxo. Salve a identidade apenas explicitamente. Entradas e alterações em apps exigem controle e uma observação recente; consulte a tarefa antes de repetir uma operação incerta.

rdp-cli android devices#

Descobre candidatos USB e Wi-Fi sem autorizá-los.

Requer um download atual com suporte a Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) ou Linux (x86_64 / ARM64).

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli android devices --help

rdp-cli android pair#

Faz o pareamento sem fio com a porta de pareamento e um código pela entrada padrão.

Requer um download atual com suporte a Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) ou Linux (x86_64 / ARM64).

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--host

Host RDP/VNC ou endereço Wi-Fi Android explícito.

TextoObrigatória
--port

Porta TCP: RDP 3389 ou VNC 5900. android pair usa a porta de pareamento do celular; ADB connect usa outra porta de conexão.

Inteiro positivoObrigatória
--code-stdin

Lê o código de pareamento de seis dígitos da entrada padrão.

SinalizadorOpcional
--device-auth-ref

Reutiliza uma identidade salva explicitamente no cofre de credenciais do sistema.

TextoOpcional
--save-device-auth

Salva explicitamente a identidade autorizada com esta referência local.

TextoOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli android pair --help

rdp-cli android forget#

Remove uma identidade Android local salva; a revogação no celular é separada.

Requer um download atual com suporte a Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) ou Linux (x86_64 / ARM64).

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--device-auth-ref

Reutiliza uma identidade salva explicitamente no cofre de credenciais do sistema.

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli android forget --help

rdp-cli android apps list#

Lista os pacotes Android instalados.

Requer um download atual com suporte a Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) ou Linux (x86_64 / ARM64).

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli android apps list --help

rdp-cli android apps info#

Consulta os caminhos reais de instalação de um pacote.

Requer um download atual com suporte a Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) ou Linux (x86_64 / ARM64).

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--package

Nome do pacote Android.

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli android apps info --help

rdp-cli android apps install#

Envia um APK único do diretório autorizado e acompanha a tarefa.

Requer um download atual com suporte a Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) ou Linux (x86_64 / ARM64).

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--path

Caminho relativo à unidade RDP ou ao diretório Android autorizado.

CaminhoObrigatória
--replace

Substitui explicitamente um app instalado.

SinalizadorOpcional
--observation

Token de uma captura recente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli android apps install --help

rdp-cli android apps launch#

Inicia um pacote e verifica sua tela.

Requer um download atual com suporte a Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) ou Linux (x86_64 / ARM64).

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--package

Nome do pacote Android.

TextoObrigatória
--activity

Classe Activity; se omitida, resolve o ponto de inicialização.

TextoOpcional
--observation

Token de uma captura recente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli android apps launch --help

rdp-cli android apps stop#

Força a parada do pacote Android explicitamente escolhido.

Requer um download atual com suporte a Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) ou Linux (x86_64 / ARM64).

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--package

Nome do pacote Android.

TextoObrigatória
--observation

Token de uma captura recente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli android apps stop --help

rdp-cli android apps status#

Consulta uma tarefa sem repetir sua operação.

Requer um download atual com suporte a Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) ou Linux (x86_64 / ARM64).

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--job

ID da tarefa retornado ao instalar, iniciar ou parar.

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli android apps status --help

rdp-cli android touch#

Envia um gesto de toque completo e temporizado com uma captura recente.

Requer um download atual com suporte a Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) ou Linux (x86_64 / ARM64).

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--kind

Tipo de gesto de toque.

Escolha
tap | double-tap | long-press | swipe | drag | pinch | gesture
Obrigatória
--x

Coordenada x remota

InteiroOpcional
--y

Coordenada y remota

InteiroOpcional
--to-x

Coordenada x final

InteiroOpcional
--to-y

Coordenada y final

InteiroOpcional
--second-x

Coordenada X inicial do segundo dedo.

InteiroOpcional
--second-y

Coordenada Y inicial do segundo dedo.

InteiroOpcional
--second-to-x

Coordenada X final do segundo dedo.

InteiroOpcional
--second-to-y

Coordenada Y final do segundo dedo.

InteiroOpcional
--duration-ms

Duração de 1–10000 ms; arrastar acrescenta uma pressão de 400 ms.

Inteiro positivoOpcional
--events-stdin

Lê um array JSON [{at_ms,contact,phase,x,y}, …] de stdin; somente para --kind gesture.

SinalizadorOpcional
--observation

Token de uma captura recente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli android touch --help

rdp-cli android key#

Pressiona uma tecla do sistema Android com controle e observação recente.

Requer um download atual com suporte a Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) ou Linux (x86_64 / ARM64).

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--key

Nome da tecla; android key usa as teclas do sistema listadas.

Escolha
back | home | recent | enter | backspace
Obrigatória
--observation

Token de uma captura recente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli android key --help

rdp-cli android text#

Cola Unicode explicitamente pela área de transferência do celular.

Requer um download atual com suporte a Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) ou Linux (x86_64 / ARM64).

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--method

Método de texto explícito: colagem por clipboard.

Escolha
clipboard
Obrigatória
--text

Texto Unicode de entrada ou da área de transferência

TextoOpcional
--text-stdin

Ler o texto de entrada ou da área de transferência até EOF

SinalizadorOpcional
--observation

Token de uma captura recente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli android text --help

Desktops e aplicativos Linux

Use --protocol x11, escolha desktop ou application e verifique a identidade SSH. O cliente SSH e a tela do aplicativo são integrados. O Wayland usa um destino RDP/VNC já configurado. O X11 não possui canais de áudio ou microfone. O SFTP fica no diretório autorizado; nenhum serviço remoto é instalado.

rdp-cli linux targets#

Descobre telas Linux e destinos compatíveis existentes sem iniciar serviços.

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--host

Host RDP/VNC ou endereço Wi-Fi Android explícito.

TextoObrigatória
--user

Conta local ou de domínio; obrigatória para RDP

TextoObrigatória
--port

Porta TCP: RDP 3389 ou VNC 5900. android pair usa a porta de pareamento do celular; ADB connect usa outra porta de conexão.

Inteiro positivo
Padrão: 22
Opcional
--ssh-known-hosts

Arquivo local known_hosts do OpenSSH; não requer um executável SSH externo.

CaminhoOpcional
--ssh-host-key

Impressão digital SSH SHA256 verificada de forma independente.

TextoOpcional
--ssh-key

Chave SSH privada local; a entrada de senha fornece sua frase secreta.

CaminhoOpcional
--password

Senha; VNC clássico usa os primeiros 8 bytes UTF-8

TextoOpcional
--password-stdin

Ler a senha da entrada padrão até EOF

SinalizadorOpcional
--credential-ref

Referência existente no armazenamento de credenciais

TextoOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli linux targets --help

rdp-cli linux text#

Digita texto ou cola explicitamente pela área de transferência remota.

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--method

Método de texto explícito: colagem por clipboard.

Escolha
clipboard
Obrigatória
--keys

Combinação como CTRL+S

Escolha
CTRL+V | CTRL+SHIFT+V | SHIFT+INSERT
Padrão: CTRL+V
Opcional
--text

Texto Unicode de entrada ou da área de transferência

TextoOpcional
--text-stdin

Ler o texto de entrada ou da área de transferência até EOF

SinalizadorOpcional
--observation

Token de uma captura recente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli linux text --help

rdp-cli linux apps list#

Lista as instâncias X11 encaminhadas nesta sessão.

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli linux apps list --help

rdp-cli linux apps stop#

Encerra uma instância de aplicativo escolhida explicitamente.

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--instance

ID exato da instância retornado por linux apps list.

TextoObrigatória
--observation

Token de uma captura recente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli linux apps stop --help

Operações e eventos

operations status consulta operation ID ou request ID original sem reenviar entrada. events lê eventos; --follow acompanha, --after retoma pelo cursor. Mesmo sent exige verificar a aplicação remota.

rdp-cli operations status#

Consultar resultado retido

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--operation-id

Identificador da operação

TextoOpcional
--request-id

ID de correlação/idempotência; operations status consulta a solicitação original

TextoOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli operations status --help

rdp-cli events#

Ler ou acompanhar eventos

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--follow

Continuar acompanhando eventos novos

SinalizadorOpcional
--after

Retorna eventos ou amostras PCM após esta sequência.

TextoOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli events --help

Confiança, credenciais e instalação

trust associa destino RDP e impressão digital no modo estrito. credentials remove apaga a referência indicada. No macOS e Linux, install-cli/uninstall-cli gerenciam a entrada CLI e --prefix escolhe o local; Windows executa o arquivo baixado. presence show --panel abre o painel de sessões no macOS e Linux. licenses mostra versões e licenças de terceiros.

rdp-cli trust list#

Listar confiança de certificados RDP

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli trust list --help

rdp-cli trust add#

Confiar em impressão digital específica

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--target

Destino de confiança RDP

TextoObrigatória
--fingerprint

Impressão digital do certificado

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli trust add --help

rdp-cli trust remove#

Remover registro de confiança

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--target

Destino de confiança RDP

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli trust remove --help

rdp-cli credentials remove#

Remover credencial do produto

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--reference

Referência de credencial a remover

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli credentials remove --help

rdp-cli install-cli#

Instalar a entrada CLI no macOS ou Linux

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--prefix

Prefixo de instalação controlado pelo usuário

CaminhoOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli install-cli --help

rdp-cli uninstall-cli#

Remover entrada CLI criada

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli uninstall-cli --help

rdp-cli licenses#

Mostrar versões e licenças de terceiros

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli licenses --help

Tarefas e automação de agentes

Adiciona capturas por região e comparação de imagens, esperas condicionais, lotes de ações, relatórios persistentes, colaboração entre agentes, MCP com perfis e diagnósticos e telas virtuais Android.

rdp-cli tasks create#

Criar uma tarefa persistente

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--title

Título da tarefa

TextoObrigatória
--session

ID explícito da sessão

TextoOpcional
--record-frames

Salvar explicitamente quadros importantes

SinalizadorOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli tasks create --help

rdp-cli tasks list#

Listar tarefas autorizadas

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli tasks list --help

rdp-cli tasks status#

Consultar progresso e histórico

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--task

ID da tarefa persistente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli tasks status --help

rdp-cli tasks attach#

Associar uma sessão autorizada à tarefa

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--task

ID da tarefa persistente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli tasks attach --help

rdp-cli tasks checkpoint#

Salvar um ponto de verificação sem repetir entradas

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--task

ID da tarefa persistente

TextoObrigatória
--note

Nota de progresso sem segredos

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli tasks checkpoint --help

rdp-cli tasks new-run#

Iniciar nova execução a partir de um ponto de verificação

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--task

ID da tarefa persistente

TextoObrigatória
--from-checkpoint

ID de ponto de verificação existente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli tasks new-run --help

rdp-cli tasks grants list#

Listar permissões da tarefa

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--task

ID da tarefa persistente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli tasks grants list --help

rdp-cli tasks grants grant#

Conceder permissões da tarefa

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--task

ID da tarefa persistente

TextoObrigatória
--to-agent

Identidade do agente de destino

TextoObrigatória
--permission

Permissão concedida ao token de acesso

TextoObrigatória · Repetível
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli tasks grants grant --help

rdp-cli tasks grants revoke#

Revogar acessos futuros à tarefa

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--task

ID da tarefa persistente

TextoObrigatória
--to-agent

Identidade do agente de destino

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli tasks grants revoke --help

rdp-cli tasks evidence#

Salvar evidências locais selecionadas

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--task

ID da tarefa persistente

TextoObrigatória
--file

Arquivo local de evidência, até 4 MiB

CaminhoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli tasks evidence --help

rdp-cli tasks export#

Exportar relatório JSON ou HTML offline

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--task

ID da tarefa persistente

TextoObrigatória
--out

Arquivo PNG de destino

CaminhoObrigatória
--format

Formato de saída; veja os valores deste comando

Escolha
json | html
Padrão: json
Opcional
--include-evidence

Incluir evidências salvas explicitamente

SinalizadorOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli tasks export --help

rdp-cli tasks purge#

Apagar o histórico local selecionado

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--task

ID da tarefa persistente

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli tasks purge --help

rdp-cli agents register#

Registrar a identidade de um agente

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--name

Nome legível da sessão

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli agents register --help

rdp-cli agents list#

Listar agentes sem revelar segredos

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli agents list --help

rdp-cli agents show#

Consultar identidade e permissões de um agente

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--id

Identidade de destino

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli agents show --help

rdp-cli agents revoke#

Revogar o agente e suas permissões de controle

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--id

Identidade de destino

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli agents revoke --help

rdp-cli agents grant#

Autorizar um agente na sessão

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--id

Identidade de destino

TextoObrigatória
--permission

Permissão concedida ao token de acesso

TextoObrigatória · Repetível
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli agents grant --help

rdp-cli agents revoke-access#

Revogar o acesso do agente à sessão

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--id

Identidade de destino

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli agents revoke-access --help

rdp-cli control claim#

Assumir sessão pausada como agente identificado

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--lease-seconds

Duração do controle em segundos

Inteiro positivo
Padrão: 60
Opcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli control claim --help

rdp-cli control renew#

Renovar uma permissão de controle válida

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--lease-seconds

Duração do controle em segundos

Inteiro positivo
Padrão: 60
Opcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli control renew --help

rdp-cli control unclaim#

Liberar o controle e pausar a sessão

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli control unclaim --help

rdp-cli control claim-status#

Consultar a permissão de controle atual

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli control claim-status --help

rdp-cli control handoff#

Transferir o controle para um agente autorizado

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--to-agent

Identidade do agente de destino

TextoObrigatória
--lease-seconds

Duração do controle em segundos

Inteiro positivo
Padrão: 60
Opcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli control handoff --help

rdp-cli profiles list#

Listar perfis de conexão

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli profiles list --help

rdp-cli profiles show#

Consultar perfil e origem dos parâmetros

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--name

Nome legível da sessão

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli profiles show --help

rdp-cli profiles save#

Salvar perfil com referências às credenciais

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--json

JSON com versão para este comando

TextoObrigatória
--replace

Substitui explicitamente um app instalado.

SinalizadorOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli profiles save --help

rdp-cli profiles remove#

Remover perfil preservando credenciais

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--name

Nome legível da sessão

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli profiles remove --help

rdp-cli profiles export#

Exportar perfil sem segredos

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--name

Nome legível da sessão

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli profiles export --help

rdp-cli profiles import#

Importar perfil sem conectar

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--json

JSON com versão para este comando

TextoObrigatória
--replace

Substitui explicitamente um app instalado.

SinalizadorOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli profiles import --help

rdp-cli doctor#

Diagnosticar recursos; o teste de conexão exige opção explícita

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--session

ID explícito da sessão

TextoOpcional
--profile

Perfil de conexão salvo

TextoOpcional
--probe

Criar explicitamente uma conexão temporária do perfil

SinalizadorOpcional
--redact

Omitir nomes, endereços e IDs de sessão

SinalizadorOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli doctor --help

rdp-cli doctor status#

Consultar diagnóstico

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--diagnostic-id

ID original da solicitação de diagnóstico

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli doctor status --help

rdp-cli doctor cancel#

Cancelar o diagnóstico restante

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--diagnostic-id

ID original da solicitação de diagnóstico

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli doctor cancel --help

rdp-cli wait#

Aguardar uma condição de imagem ou estado

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--condition

Condição de espera

Escolha
changed | stable | connection | transfer | operation
Obrigatória
--region

Região x,y,width,height em pixels remotos

TextoOpcional
--state

Estado da tecla ou do áudio mudo conforme os valores listados

TextoOpcional
--transfer-id

ID da transferência; files status sem ele lista as transferências

TextoOpcional
--operation-id

Identificador da operação

TextoOpcional
--sample-ms

Intervalo de amostragem em milissegundos

Inteiro positivo
Padrão: 100
Opcional
--stable-ms

Duração contínua de estabilidade em milissegundos

Inteiro positivo
Padrão: 1000
Opcional
--threshold-permille

Proporção de pixels alterados em milésimos

Inteiro
Padrão: 10
Opcional
--pixel-delta

Diferença de canal RGB a ignorar

Inteiro
Padrão: 8
Opcional
--max-frame-age-ms

Idade máxima do quadro em milissegundos

Inteiro positivo
Padrão: 5000
Opcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli wait --help

rdp-cli wait status#

Consultar resultado da espera

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--wait-id

ID original da solicitação de espera

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli wait status --help

rdp-cli wait cancel#

Cancelar a espera sem cancelar a operação observada

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--wait-id

ID original da solicitação de espera

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli wait cancel --help

rdp-cli batch#

Executar até 64 etapas após validação

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--json

JSON com versão para este comando

TextoOpcional
--steps-stdin

Ler JSON do lote pela entrada padrão

SinalizadorOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli batch --help

rdp-cli batch status#

Consultar lote sem repetir etapas

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--batch-id

ID original da solicitação do lote

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli batch status --help

rdp-cli batch cancel#

Cancelar etapas pendentes do lote

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--batch-id

ID original da solicitação do lote

TextoObrigatória
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli batch cancel --help

rdp-cli operations cancel#

Cancelar entradas pendentes; entradas enviadas não são desfeitas

Exige --session SESSION.

Opções do comando
OpçãoFormato e valoresRequisito
--operation-id

Identificador da operação

TextoOpcional
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli operations cancel --help

rdp-cli mcp stdio#

Oferecer MCP pela entrada e saída padrão

Não exige sessão. A seleção opcional de sessão aparece abaixo quando disponível.

Opções do comando
OpçãoFormato e valoresRequisito
--agent-id

Agent que receberá o controle

TextoOpcional
--agent-ref

Referência de credencial do agente solicitante

TextoOpcional
--claim-ref

Referência da permissão de controle atual

TextoOpcional
--task

ID da tarefa persistente

TextoOpcional
--run

ID da execução da tarefa

TextoOpcional

rdp-cli mcp stdio --help

Condições de protocolo e plataforma

  • RDP usa --cert-policy ignore e --tls-profile modern por padrão. Servidores TLS 1.2 também podem exigir assinaturas ou cifras antigas. Para um destino antigo conhecido, tente uma vez com --tls-profile legacy, mantendo as credenciais e a política de certificados e usando um novo ID de solicitação. reconnect mantém o perfil; não há downgrade automático. strict verifica a confiança e o nome do certificado. Web HTTPS não muda.
  • A segurança do VNC depende do modo escolhido. O VNC clássico não é criptografado: use uma rede confiável ou VPN. VeNCrypt X509Plain usa TLS e exige verificar o certificado. VNC criptografado: --vnc-security x509-plain exige --user, uma fonte de senha e --vnc-tls-pin verificado por outra via. O VNC clássico não aceita --user. As opções RDP --domain, --size e --layout não se aplicam.
  • VNC não oferece arquivos, áudio, microfone ou mudanças ativas de telas. UTF-8 na área de transferência depende da negociação; caso contrário, apenas Latin-1.
  • Arquivos RDP exigem redirecionamento de unidades. Áudio, área de transferência, microfone e múltiplos monitores também dependem do servidor.
  • Windows/macOS têm visualizadores e status nativos. Linux precisa de serviços de tela/áudio e Secret Service para salvar credenciais; operações CLI compatíveis continuam disponíveis sem desktop.
  • A entrada Unicode é enviada com pausas de compatibilidade. Ajuste o timeout para textos longos e confira; nenhum visualizador garante todos os caracteres em todos os servidores.
  • Requer Android 12 ou posterior; o celular testado é o Pixel 3 com Android 12. Colar texto altera explicitamente a área de transferência do celular. O áudio de reprodução exige consentimento do sistema e respeita as restrições de captura dos apps; o microfone é outra fonte. Conectar ou reconectar não inicia a gravação automaticamente.
  • Para o Compartilhamento de Tela do macOS, informe a conta do Mac com --user e sua senha. ARD é selecionado automaticamente ou com --vnc-security ard. Uma senha VNC separada usa --vnc-security vnc-auth sem --user. ARD não criptografa o fluxo da área de trabalho; use uma rede confiável ou VPN.

Recuperação de erros

OBSERVATION_REQUIRED / INVALID_COORDINATES
Capture novamente e confira topologia e coordenadas.
SESSION_PAUSED / CONTROL_HELD_BY_HUMAN
Pare a entrada e aguarde a devolução explícita ao Agent.
AUTH_FAILED / VNC_AUTH_FAILED
Confira conta, fonte da senha e política remota.
RDP_TLS_HANDSHAKE_FAILED / CERTIFICATE_UNTRUSTED
RDP_TLS_HANDSHAKE_FAILED: confira o perfil e a criptografia do servidor; isso não prova uma versão TLS antiga ou senha incorreta. Para um destino antigo conhecido, tente connect uma vez com --tls-profile legacy e um novo ID. CERTIFICATE_UNTRUSTED: verifique confiança, nome e impressão digital real do certificado; mudar o perfil TLS não resolve a confiança.
CAPABILITY_UNAVAILABLE / CLIPBOARD_ENCODING_UNSUPPORTED
Verifique capacidades ou codificação e escolha uma operação suportada.
REQUEST_TIMEOUT / REQUEST_ID_CONFLICT / REQUEST_WINDOW_EXPIRED
Consulte operação e tela antes de repetir; não reutilize IDs com argumentos diferentes ou retenção expirada.