PowerShell Test-NetConnection: comprobar puertos y conexiones en Windows
Publicado el 2026-10-26 por frfrand
Diagnosticar conectividad a una API, SSH o PostgreSQL con PowerShell
Una API no responde y alguien dice «el servidor está caído». Antes de reiniciar nada, podés comprobar desde Windows si resolvés el dominio y si llegás al puerto esperado. PowerShell ya trae Test-NetConnection para esa tarea.
La idea es usarlo para resolver un problema de verdad, no memorizar comandos porque quedan bien en una captura. Vamos con lo esencial, un ejemplo de trabajo y los errores que más conviene evitar.
Qué hace Test-NetConnection y cuándo sirve
Una prueba TCP correcta confirma conectividad hasta un puerto, no que la aplicación responda bien. Ping usa ICMP y puede fallar aunque HTTPS funcione. Separar DNS, TCP, TLS y HTTP te ahorra tocar servicios que no están fallando.
Si estás aprendiendo, probalo primero en un repositorio o entorno de prueba. Si administrás producción, documentá el estado antes de ejecutar nada que altere archivos, historial o datos. Eso te permite entender qué cambió y recuperarte si te equivocás.
Ejemplo para copiar y 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/healthNo copies la orden final sin mirar el estado previo. Los nombres de ramas, host, usuario o rutas son ejemplos; reemplazalos por los de tu proyecto. Algunos comandos modifican archivos o hacen peticiones que pueden escribir datos.
Cómo lo usaría paso a paso
- Paso 1. Consultá primero si el nombre resuelve a la IP esperada.
- Paso 2. Probá el puerto 443; si falla, revisá red, firewall y si el proceso escucha.
- Paso 3. Si TCP funciona, realizá una petición HTTPS para comprobar certificado y respuesta.
- Paso 4. Compará el resultado desde otra red para distinguir restricciones locales.
- Paso 5. Contrastá con los logs del servidor antes de cambiar reglas.
Detenete después de cada paso y comprobá el resultado. Si algo falla, anotá el mensaje exacto antes de cambiar de estrategia. Saltar entre cinco soluciones aleatorias suele dificultar encontrar la causa real.
Un caso que podría pasarte trabajando con clientes
Publicaste una API FastAPI en un VPS y tu computadora alcanza el puerto 443, pero /health devuelve 502. Eso orienta el problema hacia Nginx o el proceso upstream, no necesariamente hacia DNS o el firewall.
El objetivo no es que «funcione una vez», sino que puedas explicar cómo lo repetís sin comprometer otra aplicación. Si hay datos o credenciales de clientes, trabajá con pruebas separadas y accesos mínimos.
El error que más veo
No interpretes PingSucceeded: False como caída del servidor. Muchos equipos bloquean ICMP deliberadamente. El puerto PostgreSQL tampoco debe exponerse sólo para que esta prueba devuelva True desde Internet.
Una regla sencilla: si no podés explicar qué hará el comando sobre tu código o servidor, mirá primero su ayuda oficial. Así evitás confundir una solución rápida con un problema nuevo.
¿Dónde entra ArduMaker?
Desde ArduMaker podés revisar dominio, servicios y terminal del VPS. Combinar esos datos con pruebas PowerShell desde tu máquina ayuda a encontrar en qué tramo falla la conexión.
Por ejemplo, podés desplegar desde un repositorio Git a un VPS, asociar un dominio HTTPS y administrar servicios y bases desde el mismo entorno. El panel reduce tareas repetitivas de infraestructura, pero no reemplaza Git, las pruebas ni la revisión de permisos del proyecto.
Preguntas rápidas antes de aplicarlo
¿Esto cambia producción? Depende de dónde ejecutes la acción. Probá localmente primero, identificá el commit o servicio afectado y prepará un plan de recuperación.
¿Cómo compruebo que salió bien? No te quedes con la ausencia de mensajes de error: revisá el estado, ejecutá un test funcional y comprobá los logs o el historial correspondiente.
¿Conviene automatizarlo? Si es repetible y tiene resultados verificables, sí. Pero la automatización debería fallar de forma clara y no esconder errores o credenciales.
Para ampliar
Resumen: la herramienta útil no es la que tiene más opciones, sino la que te permite entender qué cambió, comprobarlo y seguir trabajando sin sorpresas.