PowerShell Test-NetConnection: verificar portas e conexões no Windows
Publicado em 2026-10-26 por frfrand
Diagnosticar conectividade a uma API, SSH ou PostgreSQL com PowerShell
Uma API não responde e alguém diz «o servidor está fora do ar». Antes de reiniciar nada, você pode verificar no Windows se resolve o domínio e se chega à porta esperada. O PowerShell já traz o Test-NetConnection para essa tarefa.
A ideia é usá-lo para resolver um problema de verdade, não decorar comandos porque ficam bem em uma captura. Vamos ao essencial, um exemplo de trabalho e os erros que mais convém evitar.
O que o Test-NetConnection faz e quando serve
Um teste TCP correto confirma conectividade até uma porta, não que o aplicativo responda bem. O ping usa ICMP e pode falhar mesmo que o HTTPS funcione. Separar DNS, TCP, TLS e HTTP evita que você mexa em serviços que não estão com problema.
Se está aprendendo, teste primeiro em um repositório ou ambiente de teste. Se administra produção, documente o estado antes de executar qualquer coisa que altere arquivos, histórico ou dados. Isso permite entender o que mudou e se recuperar se errar.
Exemplo para copiar e entender
Resolve-DnsName api.ejemplo.com
Test-NetConnection api.ejemplo.com -Port 443
Test-NetConnection api.ejemplo.com -Port 22
# Test TCP no equivale a verificar respuesta HTTP
Invoke-WebRequest https://api.ejemplo.com/healthNão copie o comando final sem olhar o estado prévio. Nomes de branches, host, usuário ou caminhos são exemplos; substitua pelos do seu projeto. Alguns comandos modificam arquivos ou fazem requisições que podem gravar dados.
Como usaria passo a passo
- Passo 1. Consulte primeiro se o nome resolve para o IP esperado.
- Passo 2. Teste a porta 443; se falhar, revise a rede, o firewall e se o processo está ouvindo.
- Passo 3. Se o TCP funcionar, faça uma requisição HTTPS para verificar o certificado e a resposta.
- Passo 4. Compare o resultado a partir de outra rede para distinguir restrições locais.
- Passo 5. Contraste com os logs do servidor antes de alterar as regras.
Pare após cada passo e verifique o resultado. Se algo falhar, anote a mensagem exata antes de mudar de estratégia. Pular entre cinco soluções aleatórias costuma dificultar encontrar a causa real.
Um caso que pode acontecer com clientes
Você publicou uma API FastAPI em um VPS e seu computador alcança a porta 443, mas /health retorna 502. Isso direciona o problema para o Nginx ou o processo upstream, não necessariamente para o DNS ou o firewall.
O objetivo não é que «funcione uma vez», mas que você consiga explicar como repete isso sem comprometer outra aplicação. Se houver dados ou credenciais de clientes, trabalhe com testes separados e acessos mínimos.
O erro que mais vejo
Não interprete PingSucceeded: False como queda do servidor. Muitos equipamentos bloqueiam ICMP deliberadamente. A porta do PostgreSQL também não deve ser exposta apenas para que este teste retorne True a partir da Internet.
Uma regra simples: se você não puder explicar o que o comando fará no seu código ou servidor, consulte primeiro a ajuda oficial. Assim, você evita confundir uma solução rápida com um novo problema.
Onde entra o ArduMaker?
No ArduMaker, você pode revisar domínio, serviços e terminal do VPS. Combinar esses dados com testes do PowerShell na sua máquina ajuda a encontrar em qual trecho a conexão falha.
Por exemplo, você pode implantar de um repositório Git para um VPS, associar um domínio HTTPS e administrar serviços e bancos de dados no mesmo ambiente. O painel reduz tarefas repetitivas de infraestrutura, mas não substitui o Git, os testes nem a revisão de permissões do projeto.
Perguntas rápidas antes de aplicá-lo
Isso altera a produção? Depende de onde você executa a ação. Teste localmente primeiro, identifique o commit ou serviço afetado e prepare um plano de recuperação.
Como comprovar que deu certo? Não fique apenas na ausência de mensagens de erro: revise o status, execute um teste funcional e verifique os logs ou o histórico correspondente.
Vale a pena automatizá-lo? Se for repetível e tiver resultados verificáveis, sim. Mas a automação deve falhar de forma clara e não esconder erros ou credenciais.
Para ampliar
Resumo: a ferramenta útil não é a que tem mais opções, mas sim a que permite entender o que mudou, comprovar isso e continuar trabalhando sem surpresas.