> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/automate-protect-and-extend/es/integraciones-y-api/powershell-module.md).

# Módulo PowerShell de VergeOS (PSVergeOS)

## Descripción general

PSVergeOS es un módulo de PowerShell para administrar la infraestructura de VergeOS a través de la API REST. Proporciona más de 200 cmdlets para automatizar el ciclo de vida de las VM, redes, almacenamiento, operaciones multiinquilino y flujos de trabajo de recuperación ante desastres, lo que permite a los administradores aprovechar su experiencia en PowerShell para la administración de VergeOS.

## Características clave

* **Gestión de VM**: Creación, configuración, control de energía, clonación, instantáneas y migración
* **Redes avanzadas**: Redes virtuales, reglas de firewall, DHCP, DNS, VPN IPSec y WireGuard
* **NAS y almacenamiento**: Administración de volúmenes, recursos compartidos CIFS/NFS y sincronización
* **Multitenencia**: Aprovisionamiento de inquilinos con aislamiento de recursos
* **Recuperación ante desastres**: Instantáneas en la nube, sincronización de sitios, flujos de trabajo de recuperación
* **Compatibilidad con canalización**: Cmdlets encadenables para operaciones masivas
* **Multiplataforma**: Windows, macOS y Linux con PowerShell 7.4+

## Requisitos

* PowerShell 7.4 o posterior
* VergeOS 26.0 o posterior

## Instalación

### Desde PowerShell Gallery (Recomendado)

```powershell
Install-Module -Name PSVergeOS -Scope CurrentUser
```

### Instalación manual

```powershell
git clone https://github.com/verge-io/PSVergeOS.git
Import-Module ./PSVergeOS/PSVergeOS.psd1
```

## Autenticación

El módulo admite varios métodos de autenticación:

* **Credenciales interactivas**: Solicita nombre de usuario y contraseña en tiempo de ejecución
* **Objetos PSCredential**: Automatiza la autenticación con credenciales almacenadas
* **Tokens de API**: Usa tokens pregenerados para escenarios no interactivos
* **Certificados autofirmados**: Opción para omitir la validación de certificados en entornos de prueba

## Cmdlets disponibles

El módulo contiene más de 200 cmdlets organizados por categoría:

| Categoría               | Descripción                                                        |
| ----------------------- | ------------------------------------------------------------------ |
| Conexión                | Conectar, desconectar y administrar conexiones al servidor         |
| Máquinas virtuales      | Ciclo de vida, instantáneas, unidades, NICs                        |
| Redes                   | Redes, reglas, DNS, DHCP, diagnósticos                             |
| VPN                     | Conexiones/políticas IPSec, interfaces/pares WireGuard             |
| NAS/Almacenamiento      | Servicios, volúmenes, comparticiones, instantáneas, sincronización |
| Inquilinos              | Aprovisionamiento, instantáneas, asignación de almacenamiento      |
| Usuarios y grupos       | Administración de cuentas, permisos, claves API                    |
| Sistema                 | Clústeres, nodos, licencias, configuración                         |
| Monitorización          | Alarmas, registros, tareas                                         |
| Copia de seguridad y DR | Perfiles, instantáneas en la nube, administración de sitios        |

## Casos de uso comunes

* **Operaciones masivas de VM**: Detener, iniciar, tomar instantáneas o migrar varias VM con compatibilidad con canalización
* **Informes de infraestructura**: Exportar inventario de VM, uso de recursos y datos de configuración
* **Automatización de red**: Crear redes, configurar DHCP y administrar reglas de firewall
* **Mantenimiento programado**: Integrar con el Programador de tareas o cron para operaciones automatizadas
* **Integración CI/CD**: Aprovisionar entornos de prueba como parte de los canales de implementación

Para ver ejemplos de código, consulta el [directorio Examples](https://github.com/verge-io/PSVergeOS/tree/main/Examples) en el repositorio de GitHub.

## Documentación y recursos

Para ver la documentación completa, incluidos todos los cmdlets, parámetros y ejemplos detallados de uso, visita el repositorio oficial:

* [Repositorio de GitHub](https://github.com/verge-io/PSVergeOS)
* [PowerShell Gallery](https://www.powershellgallery.com/packages/PSVergeOS)

## Soporte

Si encuentra problemas o tiene solicitudes de funciones, abra un issue en el repositorio de GitHub:

<https://github.com/verge-io/PSVergeOS/issues>

## Recursos adicionales

* [Documentación de PowerShell](https://learn.microsoft.com/en-us/powershell/)
* [Documentación de la API de VergeOS](/knowledge-base/es/automation-api/verge-api-guide.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/automate-protect-and-extend/es/integraciones-y-api/powershell-module.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.