Déployez des Labs complets avec AutomatedLab et PowerShell

I. Présentation

Si vous cherchez une façon efficace de déployer des labs de machines virtuelles Windows, Windows Server et Linux sur un serveur Hyper-V, VMware ou dans le Cloud Azure, vous devriez vous intéresser à AutomatedLab ! D'ailleurs, dans cet article, nous verrons comment installer AutomatedLab et comment créer un premier lab constitué de plusieurs machines virtuelles !

Cette solution open source facilite la construction et la destruction d'environnements de type "laboratoire", grâce au déploiement de machines virtuelles basé sur des scénarios : Active Directory, ADFS, Microsoft Exchange Server, SQL Server, SharePoint Server, Microsoft Endpoint Configuration Manager, ou encore MDT. Par exemple, vous pouvez déployer une infrastructure Active Directory basée sur 3 forêts ou encore une PKI à deux niveaux.

• Cliquez ici pour regarder la vidéo sur YouTube

Nous pouvons imaginer différents scénarios d'utilisation d'AutomatedLab, notamment :

• Expérimenter de nouvelles configurations, à titre personnel ou professionnel
• Construire une infrastructure prête à l'emploi, facilement déployable, pour une formation

Dans le cadre de ce tutoriel, AutomatedLab est installé sur un serveur Windows Server 2025 où le rôle Hyper-V est installé.

II. Ce que vous devez savoir sur AutomatedLab

Avant de commencer à utiliser AutomatedLab (AL), il est recommandé de prendre connaissance de ses prérequis et des différentes ressources que nous avons à notre disposition.

Voici les prérequis à respecter :

• .NET 4.7.1 (Windows PowerShell) ou .NET Core 2+ (PowerShell 6+)
• Un serveur Hyper-V, un abonnement Azure ou une infrastructure VMware
• Vous devez utiliser des images ISO en anglais ("en-us"), sinon elles seront ignorées par AL.
• Le système de "Rôles" livré avec AutomatedLab comprend uniquement des rôles pour Windows Server

Vous devez aussi prévoir de la RAM et de l'espace disque suffisant pour vos machines virtuelles. Si vous envisagez un laboratoire avec 5 ou 6 machines virtuelles, il est évident qu'il faudra disposer de ressources importantes. Néanmoins, vous pouvez tout à fait utiliser AutomatedLab pour déployer facilement 1 VM prête à l'emploi en quelques minutes.

AutomatedLab prend en charge les systèmes d'exploitation Windows, Windows Server, et certaines distributions Linux. La liste complète des OS et des produits supportés est disponible dans la documentation.

Concernant les ressources indispensables à utiliser, vous avez :

• Documentation officielle - AutomatedLab
• GitHub - AutomatedLab - Sample Scripts

Désormais, nous allons passer à la suite : l'installation d'AutomatedLab !

III. Installation d'AutomatedLab sur Windows Server

Nous allons commencer par préparer notre environnement pour AutomatedLab, ce qui nécessite plusieurs étapes : installation du rôle, création d'un dossier pour les sources (dépôts) et ajout d'images ISO.

Connectez-vous sur la machine sur laquelle vous souhaitez installer AutomatedLab. Ici, nous n'allons pas utiliser le package MSI. Nous allons effectuer l'installation manuellement. Tout d'abord, ouvrez une console PowerShell et exécutez la commande suivante pour installer le module AutomatedLab :

Install-Module AutomatedLab -SkipPublisherCheck -AllowClobber

Il est également recommandé d'installer le module Pester pour qu'AutomatedLab puisse effectuer des tests de validation (tests unitaires) à la fin de la création d'un lab. Pester 5.0 ou supérieur est nécessaire. Ces tests permettront de savoir si certaines actions ont échoué.

Install-Module -Name Pester -Force -SkipPublisherCheck

Ensuite, vous devez créer un nouveau dépôt pour AutomatedLab. Ici, la lettre "V" est spécifiée, il va donc créer le répertoire "V:\LabSources" avec un ensemble de sous-dossiers (ISOs, CustomRoles, Tools, SampleScripts, SoftwarePackages, etc.).

New-LabSourcesFolder -DriveLetter V

Vous devez stocker vos images ISO dans le répertoire suivant :

V:\LabSources\ISOs

Comme vous pouvez vous en douter, sans image ISO, il sera impossible d'installer le moindre système d'exploitation. Après avoir copié vos images ISO dans ce répertoire, exécutez la commande ci-dessous :

Get-LabAvailableOperatingSystem

Pour ma part, j'ai ajouté trois images ISO pour : Windows 11, Windows Server 2025 et Windows Server 2022. Elles sont bien détectées et prises en charge par AutomatedLab. La colonne "OperatingSystemName" est importante, car elle donne le nom qu'il faudra utiliser pour utiliser telle ou telle version de chaque OS.

Désormais, votre serveur est prêt : vous allez pouvoir déployer votre premier laboratoire avec AutomatedLab ! Cela signifie que nous allons automatiser la création des switchs virtuels Hyper-V, ainsi que la création, l'installation et la configuration des machines virtuelles.

IV. Créer un premier lab avec AutomatedLab

A. L'objectif : un laboratoire Active Directory

AutomatedLab contient de nombreuses options et commandes. C'est un outil très flexible qui nécessite du temps pour être pris en main. Ici, nous allons commencer par déployer un laboratoire nommé "LabAD" avec 3 machines virtuelles :

Nom de la VM	Rôle	Système d'exploitation	Adresse IP
VM-SRV-ADDS-01	AD DS (Active Directory)	Windows Server 2025 avec Expérience de Bureau	192.168.10.101 - LabADNet
VM-Routeur	Routage	Windows Server 2022 (Core)	192.168.10.1 - LabADNet DHCP - LabWAN
VM-PC-WIN-01	Poste de travail intégré au domaine	Windows 11 Pro	192.168.10.102 - LabADNet

Ces machines seront connectées à un réseau local virtuel interne nommé "LabADNet". La machine virtuelle "VM-Routeur" quant à elle, sera, en plus, connectée à un commutateur virtuel nommé "LabWAN" qui donne accès au réseau local physique sur lequel est connecté l'Hyper-V. Elle jouera le rôle de routeur pour nos machines virtuelles "VM-SRV-ADDS-01" et "VM-PC-WIN-01" afin de leur offrir un accès à Internet.

Remarque : le rôle "Routing" d'AutomatedLab ne fonctionne pas actuellement avec Windows Server 2025. C'est pour cette raison que le routeur sera exécuté sous Windows Server 2022.

B. Le fichier de configuration

Pour créer votre Lab, vous devez utiliser les commandes PowerShell du module AutomatedLab afin de définir la configuration de l'environnement que vous souhaitez déployer. Ici, nous allons créer un fichier de script nommé "AutomatedLab-AD1.ps1" et ajouter un ensemble de commandes à l'intérieur.

Nous n'utiliserons pas toutes les commandes disponibles, car il y en a beaucoup, y compris pour répondre à des besoins spécifiques. Voici les commandes que nous allons utiliser :

• New-LabDefinition : déclarer un nouveau laboratoire
• Add-LabVirtualNetworkDefinition : déclarer un nouveau commutateur virtuel (il sera créé si nécessaire)
• New-LabNetworkAdapterDefinition : déclarer une nouvelle carte réseau (que l'on assignera ensuite à une VM)
• Add-LabMachineDefinition : déclarer une nouvelle machine virtuelle
• Get-LabMachineRoleDefinition : déclarer la configuration d'un rôle, par exemple, un domaine Active Directory
• Install-Lab : initier la création du lab

Grâce à l'utilisation de 6 commandes PowerShell, nous allons pouvoir construire notre projet !

C. Étape n°1 : déclarer le nouveau lab

Désormais, nous allons ajouter du code à notre fichier "AutomatedLab-AD1.ps1" pour déclarer notre configuration. La première étape, obligatoire, consiste à # déclarer le nouveau Lab nommé "LabAD", le type d'hyperviseur et la cible pour stocker les VM.

New-LabDefinition -Name LabAD -DefaultVirtualizationEngine HyperV -VmPath "V:\LabVMs"

D. Étape n°2 : définir les paramètres par défaut

Ensuite, nous allons exploiter la variable $PSDefaultParameterValues de PowerShell pour définir les paramètres par défaut pour toutes nos machines virtuelles. Ici, vous pouvez déclarer les paramètres communs à votre VM, ce qui n'empêche pas de gérer les cas particuliers par la suite.

# Paramètres par défaut pour les VM du lab
$PSDefaultParameterValues = @{
    'Add-LabMachineDefinition:Network' = 'LabADNet'
    'Add-LabMachineDefinition:Memory' = 4GB
    'Add-LabMachineDefinition:DnsServer1'= '192.168.10.101'
    'Add-LabMachineDefinition:Gateway' = '192.168.10.1'    
    'Add-LabMachineDefinition:OperatingSystem'= 'Windows Server 2025 Standard (Desktop Experience)'
    'Add-LabMachineDefinition:DomainName'= 'it-connect.local'     
}

Cette configuration va notamment (dans l'ordre) :

• Associer chaque VM au switch virtuel "LabADNet" par défaut
• Attribuer 4 Go de RAM
• Définir l'adresse IP "192.168.10.101" comme DNS primaire sur la carte réseau
• Définir l'adresse IP "192.168.10.1" comme passerelle par défaut sur la carte réseau
• Installer le système d'exploitation Windows Server 2025 Standard (avec Expérience de bureau)
• Associer les machines au domaine "it-connect.local"

Nous allons, à la suite de code, ajouter ces deux lignes pour personnaliser le nom de l'utilisateur et le mot de passe (compte local et compte du domaine). Ici, le compte est nommé "adm_itconnect" et il est associé au mot de passe "@utomatedL@b!".

Add-LabDomainDefinition -Name "it-connect.local" -AdminUser "adm_itconnect" -AdminPassword "@utomatedL@b!"
Set-LabInstallationCredential -Username "adm_itconnect" -Password "@utomatedL@b!"

E. Étape n°3 : créer les commutateurs virtuels Hyper-V

Désormais, nous allons déclarer nos deux switchs virtuels : LabADNet (Interne) et LabWAN (Externe). Il est à noter que le commutateur externe sera associé à la carte réseau nommée "Wi-Fi". Vous devez adapter selon le nom de la carte sur votre machine.

Add-LabVirtualNetworkDefinition -Name "LabADNet" -AddressSpace "192.168.10.0/24" -VirtualizationEngine HyperV -HyperVProperties @{SwitchType = "Internal"}
Add-LabVirtualNetworkDefinition -Name "LabWAN" -HyperVProperties @{ SwitchType = "External"; AdapterName = "Wi-Fi" }

AutomatedLab va créer les commutateurs virtuels Hyper-V si cela est nécessaire. S'ils existent déjà, il ne fera rien.

F. Étape n°5 : déclarer la VM routeur

À partir de maintenant, nous allons commencer à déclarer nos machines virtuelles. Ici, celle qui assumera la fonction de routeur et qui disposera donc de 2 cartes réseaux virtuelles. Pour indiquer à AutomatedLab de configurer cette VM en tant que routeur, il convient de spécifier "-Roles Routing" dans la commande "Add-LabMachineDefinition". Cette VM ne disposera pas de 4 Go de RAM, mais seulement 1 Go, d'où l'ajout du paramètre "-Memory 1024MB".

### Routeur
# Configuration de la carte réseau de la VM
$LabNet_Routeur = @()
$LabNet_Routeur += New-LabNetworkAdapterDefinition -VirtualSwitch "LabADNet" -Ipv4Address 192.168.10.1
$LabNet_Routeur += New-LabNetworkAdapterDefinition -VirtualSwitch "LabWAN" -UseDhcp

# Déclarer une nouvelle VM
Add-LabMachineDefinition -Name VM-Routeur -Roles Routing  -OperatingSystem "Windows Server 2022 Standard" `
                         -NetworkAdapter $LabNet_Routeur -Memory 1024MB

G. Étape n°6 : déclarer la VM contrôleur de domaine

Dans le même esprit, nous allons déclarer la seconde machine virtuelle : VM-SRV-ADDS-01, notre contrôleur de domaine Active Directory. Cette fois-ci, nous allons spécifier le rôle "RootDC" car il s'agit du premier contrôleur de domaine de ce nouveau domaine. Il y a d'autres rôles pour ajouter un DC à un domaine existant, créer un sous-domaine, etc... Selon l'infrastructure cible.

La variable "$ADDSConfig" est utilisée pour stocker toute la configuration de notre domaine Active Directory, notamment le nom de domaine NetBIOS (le nom de domaine DNS est défini dans les paramètres globaux). De plus, nous précisons le niveau fonctionnel du domaine et de la forêt, ainsi que le nom du site et le subnet associé.

### Contrôleur de domaine SRV-ADDS-01
# Configuration de la carte réseau de la VM
$LabNet_SRV_ADDS_01 = @()
$LabNet_SRV_ADDS_01 += New-LabNetworkAdapterDefinition -VirtualSwitch "LabADNet" -Ipv4Address 192.168.10.101

# Configurer le domaine Active Directory
$ADDSConfig = Get-LabMachineRoleDefinition -Role RootDC @{
    NetBiosDomainName = 'IT-Connect'
    ForestFunctionalLevel = 'Win2025'
    DomainFunctionalLevel = 'Win2025'
    SiteName = 'Caen'
    SiteSubnet = '192.168.10.0/24'
}

# Déclarer une nouvelle VM
Add-LabMachineDefinition -Name VM-SRV-ADDS-01 -Roles $ADDSConfig `
                         -DomainName "it-connect.local" -NetworkAdapter $LabNet_SRV_ADDS_01

Quand vous avez besoin de configurer un nouveau rôle, vous pouvez utiliser cette commande (en modifiant le nom du rôle) pour connaître la syntaxe attendue :

 Get-LabMachineRoleDefinition -Role RootDC -Syntax

H. Étape n°7 : déclarer la VM Windows 11

Enfin, terminons par déclarer la troisième VM, qui tournera sous Windows 11 Pro. Ici, il n'est pas nécessaire de spécifier un rôle.

### Poste client sous Windows 11
# Configuration de la carte réseau de la VM
$LabNet_PC_WIN_01 = @()
$LabNet_PC_WIN_01 += New-LabNetworkAdapterDefinition -VirtualSwitch "LabADNet" -Ipv4Address 192.168.10.102

# Déclarer une nouvelle VM
Add-LabMachineDefinition -Name VM-PC-WIN-01 -OperatingSystem "Windows 11 Pro" `
                         -DomainName "it-connect.local" -NetworkAdapter $LabNet_PC_WIN_01

I. Étape n°8 : construire le lab

La déclaration de la configuration de notre lab est terminée ! Il reste une seule commande à exécuter pour lancer le déploiement.

Install-Lab

Voilà ! AutomatedLab démarre le processus de construction de vos machines virtuelles ! La première fois, il va vous inviter à ajuster la configuration de votre serveur local, notamment pour désactiver certaines sécurisées liées à WinRM et CredSSP. Ceci est nécessaire pour que l'hôte Hyper-V puisse se connecter aux machines virtuelles, sans limitation. Ce risque est acceptable puisqu'il s'agit d'un environnement de tests : AutomatedLab n'est pas adapté pour déployer des environnements de production.

Il va notamment effectuer les actions suivantes :

• Vérifier la disponibilité des images ISO
• Déclarer les machines virtuelles dans le projet
• Vérifier la syntaxe de votre script AutomatedLab-AD1.ps1
• Créer les commutateurs virtuels Hyper-V
• Construire les images de base des machines virtuelles sous la forme de disques virtuels VHDX (ensuite, chaque VM sera basée sur un disque de différenciation)

• Créer chaque machine virtuelle sur Hyper-V
• Installer et configurer chaque VM, tour à tour, dans l'ordre tel qu'elles sont déclarées dans le script AutomatedLab-AD1.ps1. Même si, pour la configuration, le domaine Active Directory sera priorisé afin de pouvoir intégrer les machines au domaine.

Il ne reste plus qu'à patienter. Vous pouvez suivre l'avancement de la construction de votre laboratoire en lisant les indications dans la console PowerShell. Vous pouvez aussi regarder les écrans des machines virtuelles, sans interférer avec le processus d'AutomatedLab.

Remarque : il n'est pas à exclure qu'il y ait certaines erreurs pendant l'exécution, mais, parfois, elles ne sont pas bloquantes. Par exemple, si une machine virtuelle met du temps à démarrer ou redémarrer (suite à l'installation d'un rôle, par exemple), il peut y avoir un message qui indique une perte de connectivité.

Si vous souhaitez récupérer le fichier AutomatedLab-AD1.ps1 complet, rendez-vous sur notre GitHub :

V. Aperçu du laboratoire

30 minutes plus tard, le laboratoire est prêt à l'emploi ! Les 3 machines virtuelles sont installées et configurées. Il ne reste plus qu'à les utiliser. Désormais, vous pouvez générer ce laboratoire à la volée, selon vos besoins, et le reconstruire à souhait. Les prochaines fois, la création du laboratoire sera plus rapide, car les images de base (fichiers VHDX) seront déjà prêtes à l'emploi.

Les tests de validation, réalisés à l'aide du module Pester, montrent que tout s'est correctement déroulé pour chaque VM.

Avant d'aller plus loin, je vous recommande d'exécuter la commande suivante :

Show-LabDeploymentSummary -Detailed

Elle permet d'avoir un aperçu complet du Lab qui vient d'être généré. C'est aussi l'occasion de confirmer que les identifiants correspondent bien à nos attentes.

Si nous ouvrons le Gestionnaire Hyper-V, nous pouvons constater la présence de 3 machines virtuelles.

La machine virtuelle VM-SRV-ADDS-01 dispose bien d'un accès à Internet, grâce à notre routeur. Sur chaque VM, il y a également un fond d'écran personnalisé où est indiqué le nom de la machine, le système, le nom du domaine AD, ou encore le nom de l'utilisateur actuellement connecté.

Sur cette même machine virtuelle, le domaine Active Directory a bien été créé et il est opérationnel.

Quant à notre routeur, il s'agit bien d'une machine sous Windows Server 2022 Standard, en mode Core.

Le déploiement de cette plateforme de test sur Hyper-V a été réalisé avec succès !

VI. Aller plus loin dans la configuration

A. Options de configuration supplémentaires

Pour aller plus loin dans la personnalisation de votre déploiement, vous pouvez ajouter des actions supplémentaires à votre script. Voici quelques options à explorer.

• Utiliser la commande "Add-LabIsoImageDefinition" pour mapper une image ISO supplémentaire dans une VM. Ceci est utile pour installer certains produits comme Exchange Server ou SQL Server.
• Utiliser la commande "Install-LabSoftwarePackage" pour installer des logiciels sur une machine virtuelle.
• Ajouter des paramètres supplémentaires à la commande "Add-LabMachineDefinition" pour personnaliser vos machines virtuelles. Chaque paramètre aura un impact sur la configuration de la VM ou de son OS, comme "-TimeZone" pour définir le fuseau horaire.
• Utiliser un fichier de réponse "Unattend.xml" personnalisé pour Windows, que vous importez dans AutomatedLab.

Quand vous stockez des sources supplémentaires (ISO, package MSI, etc.), vous pouvez utiliser la variable "$labSources" pour pointer vers le répertoire de votre lab. Dans le cas présent, elle pointe vers le répertoire "V:\LabSources" initialisé précédemment avec la commande "New-LabSourcesFolder". Vous pouvez stocker vos images ISO dans le dossier "ISOs" et vos packages d'installation de logiciels dans "SoftwarePackages".

Enfin, sachez que certaines commandes, notamment pour installer des logiciels ou des fonctionnalités (Install-LabWindowsFeature), peuvent être utilisées pour interagir avec un Lab déjà déployé et que vous souhaitez améliorer.

B. Exécuter des tâches de post-déploiement

Vous pouvez également exécuter des commandes PowerShell dans une machine virtuelle que vous venez de déployer, grâce à la commande "Invoke-LabCommand". C'est l'occasion d'exécuter des actions de post-installation.

L'exemple ci-dessous permet de créer un nouvel utilisateur au sein de l'annuaire Active Directory. La commande est exécutée sur le serveur VM-SRV-ADDS-01. Il est possible de préciser plusieurs machines et le nom d'un fichier PS1 à la place d'un bloc de script (-FilePath). Vous remarquerez que cette commande, sur le papier, est similaire à la commande "Invoke-Command" de PowerShell.

# Post-déploiement - Créer un utilisateur dans AD
Invoke-LabCommand -ActivityName "AD - Create user" -ComputerName VM-SRV-ADDS-01 -ScriptBlock {

    # Créer un utilisateur dans l'Active Directory
    New-ADUser  -Name "Florian BURNEL" `
                -DisplayName "Florian BURNEL" `
                -GivenName "Florian" `
                -Surname "Burnel" `
                -SamAccountName "florian.burnel" `
                -UserPrincipalName "florian.burnel@it-connect.local" `
                -AccountPassword (ConvertTo-SecureString "@utomatedL@b!" -AsPlainText -Force) `
                -Enabled $true

}

Dans la console, cette action, nommée "AD - Create users" est visible lorsqu'elle s'exécute.

20:38:38|01:58:14|00:00:00.000|   - Executing lab command activity: 'AD - Create users' on machines 'VM-SRV-ADDS-01'
20:38:38|01:58:14|00:00:00.007|     - Waiting for completion
20:38:38|01:58:15|00:00:00.661|     - Activity done

Cela apporte une flexibilité importante pour la personnalisation des labs et l'automatisation des actions.

C. Arrêter ou démarrer les VM d'un lab

Si vous avez besoin d'arrêter l'ensemble des machines virtuelles de votre lab ou de les démarrer, vous pouvez compter sur les commandes PowerShell du module Hyper-V, ainsi que sur celles d'AutomatedLab.

Si vous ouvrez une nouvelle console PowerShell, vous devez commencer par importer votre Lab avec "Import-Lab", car c'est une façon de charger sa configuration. Ensuite, la commande "Get-LabVM" permet de lister toutes les VM du lab :

Import-Lab LabAD
Get-LabVM

Ensuite, vous pouvez démarrer toutes les VM avec cette commande :

Get-LabVM | Start-LabVM

Ou, à l'inverse, arrêter toutes les VM avec celle-ci :

Get-LabVM | Stop-LabVM

Pratique pour lancer ou arrêter facilement un lab complet !

D. Reconstruire un lab

Tout l'intérêt d'AutomatedLab, c'est aussi de pouvoir construire, détruire, et reconstruire une infrastructure complète, sans effort. De ce fait, vous pouvez supprimer un lab complet, et donc toutes les machines virtuelles associées, avec une simple commande. Attention, cette action est irréversible une fois qu'elle est initiée.

Remove-Lab -Name LabAD

Il suffit de valider avec "A" puis Entrée pour lancer l'opération.

Si vous souhaitez relancer la construction de votre laboratoire, vous n'avez qu'à relancer votre script, en l'occurrence, ici AutomatedLab-AD1.ps1.

VII. Bonus : un lab avec 5 machines virtuelles

Pour finir, je vous propose un laboratoire que vous pouvez générer avec AutomatedLab, basé sur ce modèle, et qui va permettre de créer une infrastructure basée sur 5 VM :

• LabWeb-ADDS-01 : un contrôleur de domaine Active Directory
• LabWeb-Routeur : un routeur sous Windows Server
• LabWeb-CA-01 : une autorité de certification racine ADCS
• LabWeb-WEB : un serveur web, accessible en HTTPS avec un certificat délivré par la CA
• LabWeb-PC-01 : un poste de travail sous Windows 11

Ce qui donne 5 VM avec peu de ressources utilisées (optimisation) :

Vous pouvez également récupérer le code de ce lab sur notre GitHub.

VIII. Conclusion

AutomatedLab est un module PowerShell très intéressant et très puissant pour construire des laboratoires sur-mesure, des plus simples aux plus complexes. Grâce à cet article, vous disposez d'un exemple clé en main pour vous entrainer et comprendre la mécanique de l'outil. Mais, il n'y a pas de secret, pour bien prendre en main AutomatedLab, il va falloir manipuler et faire des tests !

En complément de cet article, je vous encourage à parcourir la documentation et à vous inspirer des fichiers de scénarios existants. Si vous avez besoin d'aide pour monter en compétences sur PowerShell et Hyper-V, retrouvez nos cours :

• Débuter avec le langage PowerShell
• Débuter avec Hyper-V sous Windows Server