For the complete documentation index, see llms.txt. This page is also available as Markdown.

Módulo PowerShell de VergeOS (PSVergeOS)

PSVergeOS es un módulo de PowerShell que proporciona más de 200 cmdlets para administrar la infraestructura de VergeOS a través de la API REST, habilitando la automatización de VM, redes, almacenamiento, inquilinos y recuperación ante desastres.

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

Instalación manual

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 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:

Soporte

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

Recursos adicionales

Última actualización

¿Te fue útil?