feat: funciones PowerShell infra — firewall y portproxy

Funciones PowerShell para gestión de red en Windows: win_firewall_add_rule, win_firewall_remove_rule, win_portproxy_add y win_portproxy_remove. Útiles para configurar acceso de red en entornos WSL2. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-30 14:24:45 +02:00
parent 3c250a9252
commit 2fbf4ef62e
8 changed files with 426 additions and 0 deletions
@@ -0,0 +1,46 @@
+---
+name: win_firewall_remove_rule
+kind: function
+lang: ps
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "win_firewall_remove_rule -Name <string>"
+description: "Elimina una regla del firewall de Windows por nombre. Si la regla no existe, termina con éxito sin hacer nada (idempotente). Requiere privilegios de Administrador."
+tags: [firewall, windows, netsh, network, infra, security, cleanup, wsl2]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: []
+tested: false
+tests: []
+test_file_path: ""
+file_path: "powershell/functions/infra/win_firewall_remove_rule.ps1"
+---
+
+## Uso
+
+```powershell
+# Desde PowerShell (como Administrador)
+.\win_firewall_remove_rule.ps1 -Name "CDP-9222"
+```
+
+```bash
+# Desde WSL2
+powershell.exe -ExecutionPolicy Bypass -File win_firewall_remove_rule.ps1 -Name "CDP-9222"
+```
+
+## Parametros
+
+| Parametro | Tipo   | Obligatorio | Descripcion                       |
+|-----------|--------|-------------|-----------------------------------|
+| `-Name`   | string | si          | Nombre exacto de la regla a eliminar |
+
+## Notas
+
+- Requiere ejecutarse como **Administrador** en Windows.
+- Idempotente: si la regla no existe, sale con exit code 0 y mensaje informativo.
+- Complementa `win_firewall_add_rule` para teardown limpio de reglas temporales.
+- Retorna exit code 0 si tuvo éxito (o la regla no existía), 1 si hubo error.