Mostrar navegação na documentação

Executando comandos

Envie um conjunto de comandos para dispositivos selecionados e acompanhe o progresso e os resultados juntos.

Aplica-se a
RouterOS 6.49.x e 7.21.x/7.23.x
Última atualização
Janela de lote separada após uma consulta somente leitura: status por dispositivo e saída real.
Janela de lote separada após uma consulta somente leitura: status por dispositivo e saída real.

Abra a janela de lote separada#

Selecione dispositivos, protocolo e credenciais na tela inicial e abra Comandos em lote à direita (Ctrl+R). A linha superior mostra os dispositivos capturados, o protocolo e as credenciais resolvidas, incluindo contagens executáveis, ignoradas e ocultadas por filtro. Os comandos estão à esquerda e os resultados à direita.

Mudanças iniciais e o instantâneo atual#

Alterações posteriores em dispositivos, protocolo ou credenciais na tela inicial não alteram este lote. As ações de nova tentativa, exportação de status e lista salva usam seu instantâneo.

Quando ocioso, adote as configurações iniciais atuais. A limpeza dos resultados existentes requer confirmação. Durante a execução, a reabertura apenas avança a janela. Os dispositivos ignorados apresentam motivos e não adquirem uma concessão de gravação.

Esta página é o detalhe. Se você ainda não executou nada, comece com Introdução.

Escolha a opção certa#

Existem mais opções do que tipos de conexão, pois aquela que o WinBox utiliza oferece mais de uma forma de entrega de um script. Eles podem fazer coisas diferentes e não são intercambiáveis.

OpçãoRouterOSComo chega láRoteiro mais longo
8291, linha por linha (padrão)6.x/7.xDigitado uma linha por vez como se estivesse no terminal; o próprio prompt do dispositivo diz quando uma linha é concluída256 KiB
8291, tudo de uma só vez6.x/7.xTudo funciona junto; a tela ecoa mais lentamente para scripts longos24 KiB
SSH (opcional)6.x/7.xA coisa toda é enviada por SSH e executada60 KiB
API (opcional)7.x apenasA coisa toda é entregue ao dispositivo como uma corda para executar60 KiB
REST (opcional)7.x apenasTudo é enviado através do canal de interface web do dispositivo60 KiB

Quando usar qual#

  • Linha por linha é o padrão e a resposta certa na maioria das vezes. Permite enviar o máximo e funciona em ambas as gerações RouterOS.
  • Tudo de uma vez é o que você precisa quando um script declara suas próprias variáveis. Alimentar um terminal com uma linha por vez significa que uma variável declarada com :local não sobrevive além de sua própria linha - isso decorre do método de entrega, e não de qualquer coisa que o aplicativo tenha deixado de fora.
  • SSH é útil onde 8291 está bloqueado, mas SSH não. Ele precisa do /ip service ssh ligado no dispositivo.
  • API / REST são para ambientes já padronizados neles. Ambos são RouterOS 7.x apenas para execução de comandos, e REST também precisa de /ip service www ou www-ssl.

Escreva os comandos#

A caixa é de texto simples, com um contador ao lado mostrando quanto você usou em relação ao limite desta opção. O histórico mantém o que você executou antes, e tudo pode ser salvo em um arquivo e chamado de volta, portanto, uma verificação de rotina não precisa ser digitada novamente.

Comandos somente leitura para começar:

routeros
/system resource print
/interface ethernet print where running
/ip address print

Comandos que alteram o dispositivo são uma decisão sua em seu próprio equipamento. Dois hábitos que vale a pena manter:

  • Execute primeiro o comando de consulta correspondente, no mesmo conjunto de dispositivos, para saber exatamente o que está prestes a alterar.
  • Tenha cuidado com qualquer coisa que possa cortar o caminho pelo qual você está enviando - regras de firewall, desabilitar uma interface, alterar um endereço. O aplicativo não pode desfazê-los, nem uma conexão que acabou de cair.

Quantos de uma vez e quanto tempo cada um leva#

Simultaneidade é quantos dispositivos são usados ao mesmo tempo. Tempo limite por dispositivo é quanto tempo um dispositivo leva antes de ser abandonado.

  • Você pode ir até 100. Acima dos 20 recomendados, o campo diz isso – sem parar você.
  • Aumentar o volume não é automaticamente mais rápido. Os próprios dispositivos, a rede intermediária e sua própria máquina podem se tornar o primeiro gargalo.
  • O tempo limite é contado por dispositivo, para que um dispositivo lento não consuma o tempo de todos os outros.

Ele pergunta antes de enviar#

O botão de execução mostra em quantos dispositivos ele atuará — Executar 3 dispositivos, por exemplo — e ao lado dele estão escritas as mesmas contagens: quantos estão verificados, quantos podem ser executados e, se houver, quantos serão ignorados. Pressioná-lo ainda não envia nada. Uma confirmação aparece primeiro, mostrando o que está prestes a ser executado e em quantos dispositivos. Nada chega a um dispositivo porque sua mão escorregou no mouse.

Lendo resultados#

Os resultados aparecem uma linha por dispositivo em Resultados à direita da janela do lote, com um status, quanto tempo demorou e o que retornou. Apenas os dispositivos desta rodada estão listados.

EstadoSignificado
CorrendoAinda vou.
ConcluídoO dispositivo chegou ao fim dos seus comandos.
Falha na conexãoNunca conectou. Nada foi enviado.
IncertoOs comandos foram enviados e a conexão foi interrompida ou a execução foi cancelada.
CanceladoVocê parou a corrida.

O que o cancelamento faz#

Parar cancela a execução. O que isso realmente significa depende de como você está conectado:

  • Acima de 8291, o cancelamento interrompe a conexão.
  • Acima de API, SSH e REST, o cancelamento apenas interrompe este final espera. Ele não pode prometer que o comando foi interrompido no dispositivo – o dispositivo pode muito bem terminar o que já foi dado.

De qualquer forma, os dispositivos cujos comandos já foram enviados são relatados como incertos, e não como falhas, e o aplicativo não reenvia sozinho. Uma nova tentativa silenciosa é exatamente como um comando se transforma em dois.

Depois da corrida#

  • Armazenar dispositivos com problemas coleta tudo que apresentou problemas em um grupo salvo.
  • Tente novamente os dispositivos com problema execuções apenas nesses dispositivos.
  • Saída de cópia e Resumo do status da cópia colocam os resultados na área de transferência.

Próximo#

Ferramentas de edição e saída#

O editor de comandos oferece realce de sintaxe RouterOS, histórico, carregamento e salvamento e limite de bytes para o protocolo capturado. Pesquise a saída, alterne o agrupamento ou expanda os resultados. Os rótulos de progresso filtram os resultados. Lotes, backup, ciclos PoE e atualizações bloqueiam gravações conflitantes no mesmo dispositivo.

Depois de fechar a janela#

O fechamento preserva comandos, metas e resultados; reabrir da tela inicial. Durante a execução, escolha fechar janela (continuar executando), parar ou cancelar. Fechar a tela inicial sai do aplicativo e pede para parar se um lote estiver ativo. A sessão dura apenas para a execução deste aplicativo.