> 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/fr/integrations-et-api/powershell-module.md). # Module PowerShell VergeOS (PSVergeOS) ## Vue d’ensemble PSVergeOS est un module PowerShell permettant de gérer l’infrastructure VergeOS via l’API REST. Il fournit plus de 200 cmdlets pour automatiser le cycle de vie des VM, le réseau, le stockage, les opérations multi-tenant et les flux de reprise après sinistre, permettant aux administrateurs de mettre à profit leur expertise PowerShell pour la gestion de VergeOS. ## Fonctionnalités clés * **Gestion des VM**: Création, configuration, contrôle de l’alimentation, clonage, instantanés et migration * **Réseautage avancé**: Réseaux virtuels, règles de pare-feu, DHCP, DNS, VPN IPSec et WireGuard * **NAS et stockage**: Gestion des volumes, partages CIFS/NFS et synchronisation * **Multi-location**: Provisionnement des locataires avec isolation des ressources * **Reprise après sinistre**: Instantanés cloud, synchronisation de sites, workflows de reprise * **Prise en charge du pipeline**: Cmdlets enchaînables pour les opérations en masse * **Multiplateforme**: Windows, macOS et Linux avec PowerShell 7.4+ ## Prérequis * PowerShell 7.4 ou version ultérieure * VergeOS 26.0 ou version ultérieure ## Installation ### Depuis la PowerShell Gallery (recommandé) ```powershell Install-Module -Name PSVergeOS -Scope CurrentUser ``` ### Installation manuelle ```powershell git clone https://github.com/verge-io/PSVergeOS.git Import-Module ./PSVergeOS/PSVergeOS.psd1 ``` ## Authentification Le module prend en charge plusieurs méthodes d’authentification : * **Identifiants interactifs**: Invite à saisir le nom d’utilisateur et le mot de passe à l’exécution * **Objets PSCredential**: Automatiser l’authentification avec des identifiants stockés * **Jetons API**: Utiliser des jetons pré-générés pour les scénarios non interactifs * **Certificats auto-signés**: Option permettant d’ignorer la validation des certificats pour les environnements de test ## Cmdlets disponibles Le module contient plus de 200 cmdlets organisés par catégorie : | Catégorie | Description | | ------------------------------------ | --------------------------------------------------------------- | | Connexion | Se connecter, se déconnecter et gérer les connexions au serveur | | Machines virtuelles | Cycle de vie, instantanés, disques, NIC | | Réseautage | Réseaux, règles, DNS, DHCP, diagnostics | | VPN | Connexions/politiques IPSec, interfaces/peers WireGuard | | NAS/Stockage | Services, volumes, partages, instantanés, synchronisation | | Locataires | Approvisionnement, instantanés, allocation de stockage | | Utilisateurs et groupes | Gestion des comptes, autorisations, clés API | | Système | Clusters, nœuds, licences, paramètres | | Surveillance | Alertes, journaux, tâches | | Sauvegarde et reprise après sinistre | Profils, instantanés cloud, gestion des sites | ## Cas d'utilisation courants * **Opérations groupées sur les VM**: Arrêter, démarrer, créer un instantané ou migrer plusieurs VM avec prise en charge du pipeline * **Rapports d’infrastructure**: Exporter l’inventaire des VM, l’utilisation des ressources et les données de configuration * **Automatisation réseau**: Créer des réseaux, configurer DHCP et gérer les règles de pare-feu * **Maintenance planifiée**: S’intégrer au Planificateur de tâches ou à cron pour des opérations automatisées * **Intégration CI/CD**: Provisionner des environnements de test dans le cadre des pipelines de déploiement Pour des exemples de code, consultez le [répertoire d’exemples](https://github.com/verge-io/PSVergeOS/tree/main/Examples) dans le dépôt GitHub. ## Documentation et ressources Pour une documentation complète, incluant tous les cmdlets, paramètres et exemples d’utilisation détaillés, consultez le dépôt officiel : * [Dépôt GitHub](https://github.com/verge-io/PSVergeOS) * [PowerShell Gallery](https://www.powershellgallery.com/packages/PSVergeOS) ## Support Si vous rencontrez des problèmes ou avez des demandes de fonctionnalités, veuillez ouvrir un ticket sur le dépôt GitHub : ## Ressources supplémentaires * [Documentation PowerShell](https://learn.microsoft.com/en-us/powershell/) * [Documentation de l'API VergeOS](/knowledge-base/fr/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/fr/integrations-et-api/powershell-module.md?ask=&goal= ``` `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.