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

VergeOS PowerShell-Modul (PSVergeOS)

PSVergeOS ist ein PowerShell-Modul mit über 200 Cmdlets zur Verwaltung der VergeOS-Infrastruktur über die REST-API und ermöglicht die Automatisierung von VMs, Netzwerken, Speicher, Tenants und Notfallwiederherstellung.

Übersicht

PSVergeOS ist ein PowerShell-Modul zur Verwaltung der VergeOS-Infrastruktur über die REST-API. Es bietet über 200 Cmdlets zur Automatisierung von VM-Lebenszyklus, Netzwerken, Speicher, Multi-Tenant-Operationen und Disaster-Recovery-Workflows und ermöglicht Administratoren, ihre PowerShell-Expertise für die Verwaltung von VergeOS zu nutzen.

Hauptmerkmale

  • VM-Verwaltung: Erstellung, Konfiguration, Energieverwaltung, Klonen, Snapshots und Migration

  • Erweiterte Netzwerktechnik: Virtuelle Netzwerke, Firewall-Regeln, DHCP, DNS, IPSec VPN und WireGuard

  • NAS & Speicher: Volumenverwaltung, CIFS/NFS-Freigaben und Synchronisierung

  • Multi-Tenancy: Mandantenbereitstellung mit Ressourcenisolierung

  • Disaster Recovery: Cloud-Snapshots, Standortsynchronisierung, Wiederherstellungs-Workflows

  • Pipeline-Unterstützung: Verkettbare Cmdlets für Massenoperationen

  • Plattformübergreifend: Windows, macOS und Linux mit PowerShell 7.4+

Anforderungen

  • PowerShell 7.4 oder höher

  • VergeOS 26.0 oder höher

Installation

Manuelle Installation

Authentifizierung

Das Modul unterstützt mehrere Authentifizierungsmethoden:

  • Interaktive Anmeldedaten: Benutzername und Passwort zur Laufzeit abfragen

  • PSCredential-Objekte: Authentifizierung mit gespeicherten Anmeldedaten automatisieren

  • API-Tokens: Vorab generierte Tokens für nicht-interaktive Szenarien verwenden

  • Selbstsignierte Zertifikate: Option zum Überspringen der Zertifikatsvalidierung für Testumgebungen

Verfügbare Cmdlets

Das Modul enthält über 200 Cmdlets, die nach Kategorien organisiert sind:

Kategorie
Beschreibung

Verbindung

Serververbindungen herstellen, trennen und verwalten

Virtuelle Maschinen

Lebenszyklus, Snapshots, Laufwerke, NICs

Netzwerk

Netzwerke, Regeln, DNS, DHCP, Diagnose

VPN

IPSec-Verbindungen/-Richtlinien, WireGuard-Schnittstellen/-Peers

NAS/Speicher

Dienste, Volumes, Freigaben, Snapshots, Synchronisierung

Mandanten

Bereitstellung, Snapshots, Speicherzuweisung

Benutzer & Gruppen

Kontoverwaltung, Berechtigungen, API-Schlüssel

System

Cluster, Knoten, Lizenzen, Einstellungen

Überwachung

Alarme, Protokolle, Aufgaben

Sicherung & DR

Profile, Cloud-Snapshots, Site-Verwaltung

Häufige Anwendungsfälle

  • Massen-VM-Operationen: Mehrere VMs mit Pipeline-Unterstützung anhalten, starten, snapshotten oder migrieren

  • Infrastrukturberichterstattung: VM-Bestand, Ressourcennutzung und Konfigurationsdaten exportieren

  • Netzwerkautomatisierung: Netzwerke erstellen, DHCP konfigurieren und Firewall-Regeln verwalten

  • Geplante Wartung: Mit dem Taskplaner oder cron für automatisierte Vorgänge integrieren

  • CI/CD-Integration: Testumgebungen als Teil von Bereitstellungspipelines bereitstellen

Für Codebeispiele siehe das Beispielverzeichnis im GitHub-Repository.

Dokumentation und Ressourcen

Die vollständige Dokumentation, einschließlich aller Cmdlets, Parameter und detaillierter Anwendungsbeispiele, finden Sie im offiziellen Repository:

Support

Wenn Sie auf Probleme stoßen oder Funktionswünsche haben, eröffnen Sie bitte ein Issue im GitHub-Repository:

Weitere Ressourcen

Zuletzt aktualisiert

War das hilfreich?