---
name: win_portproxy_remove
kind: function
lang: ps
domain: infra
version: "1.0.0"
purity: impure
signature: "win_portproxy_remove -ListenPort <int> [-ListenAddr <string>]"
description: "Elimina una regla de port proxy v4tov4 de netsh identificada por ListenAddr:ListenPort. Si la regla no existe, termina con éxito sin hacer nada (idempotente). Requiere privilegios de Administrador."
tags: [portproxy, netsh, windows, network, infra, wsl2, cleanup, proxy]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
params:
  - name: ListenPort
    desc: "Puerto de escucha de la regla a eliminar (1-65535)"
  - name: ListenAddr
    desc: "Dirección IP de escucha (default: 0.0.0.0)"
output: "Void - elimina regla de port proxy, idempotente (no falla si no existe)"
tested: false
tests: []
test_file_path: ""
file_path: "powershell/functions/infra/win_portproxy_remove.ps1"
---

## Uso

```powershell
# Eliminar portproxy en puerto 9222 (listenaddr por defecto: 0.0.0.0)
.\win_portproxy_remove.ps1 -ListenPort 9222

# Con listenaddr explícito
.\win_portproxy_remove.ps1 -ListenAddr 0.0.0.0 -ListenPort 9222
```

```bash
# Desde WSL2
powershell.exe -ExecutionPolicy Bypass -File win_portproxy_remove.ps1 -ListenPort 9222
```

## Parametros

| Parametro     | Tipo   | Obligatorio | Default     | Descripcion                                          |
|---------------|--------|-------------|-------------|------------------------------------------------------|
| `-ListenPort` | int    | si          | —           | Puerto de escucha de la regla a eliminar (1-65535)   |
| `-ListenAddr` | string | no          | `0.0.0.0`   | Dirección IP de escucha 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_portproxy_add` para teardown limpio.
- La regla se identifica por la combinación `listenaddress:listenport` — debe coincidir exactamente con la usada en `win_portproxy_add`.
- Retorna exit code 0 si tuvo éxito (o la regla no existía), 1 si hubo error.

## Teardown completo WSL2 → Chrome CDP

```bash
# 1. Eliminar portproxy
powershell.exe -ExecutionPolicy Bypass -File win_portproxy_remove.ps1 -ListenPort 9222

# 2. Eliminar regla de firewall
powershell.exe -ExecutionPolicy Bypass -File win_firewall_remove_rule.ps1 -Name "CDP-9222"
```
