Referência de comandos do rdp-cli

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.

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.

Condições de protocolo e plataforma

• RDP usa --cert-policy ignore e --tls-profile modern. strict verifica confiança e nome; legacy permite TLS antigo explicitamente. A verificação HTTPS web não muda.
• VNC rejeita --user, --domain, --size, --layout, --cert-policy e --tls-profile. A autenticação clássica usa oito bytes UTF-8 da senha. Sem autenticação exige --vnc-security none e nenhuma senha. Os transportes VNC suportados não são criptografados.
• 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.

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

Confira TLS, certificado e impressão digital; falha TLS não significa senha errada.

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.