This document was written to support updating from older versions of this module to version 4.x. It is being retained for archive and information purposes. If you are updating from version 4.x to a later version, please refer to the latest update documentation.
This module and its dependencies will be installed and updated from the PowerShell Gallery. It is strongly recommended that you do not upgrade the module if you have configured labs and virtual machines. If AutoLab is in use now, you can wait until you are finished with the lab configuration. Otherwise, use the Wipe-Lab
command in any configuration folder that has MOF files with virtual machines.
Note: The terms AutoLab
and PSAutolab
are used interchangeably. PSAutolab is technically the PowerShell module that manages your AutoLab configuration.
You should be able to run
Update-Module PSAutolab
However, there is the potential for issues with required Lability module. You can always try this:
Update-Module Lability
Update-Module PSAutolab
In certain situations, the Lability module may encounter a security validation bug between versions. You can try this sequence of commands.
Install-Module Lability -SkipPublisherCheck -force
Update-Module PSAutolab
If you still have issues, the best course of action is to uninstall the modules and re-install.
Get-Module PSAutolab -ListAvailable | Uninstall-Module
Get-Module lability -ListAvailable | Uninstall-Module
You might need to repeat this process until this command shows no modules.
Get-Module lability,PSAutolab -ListAvailable
With a clean slate run:
Install-Module PSAutolab -SkipPublisherCheck -Force
You do not need to run Setup-Host
. But you should run Refresh-Host
to copy updated lab configurations to your Autolab setup.
If you have been using PSAutolab for awhile, are updating it and plan to continue using it, you might want to refresh the virtual disk images. An update to the PSAutolab module might also include a reference to a new version of the Lability module. This module is responsible for downloading the latest ISO images and creating the master virtual hard disks.
You should only refresh disk images if you have no configured virtual machines.
Get-ChildItem C:\autolab\VMVirtualHardDisks
If this directory is empty, then you can proceed.
Get-ChildItem D:\Autolab\MasterVirtualHardDisks\ | Remove-Item
The next time you build a lab, the master disk image will be recreated.
Likewise, you might want to refresh the ISO images found in C:\Autolab\ISOs
. You can delete any or all ISO images. The latest version of a required ISO will be downloaded the next time you build a lab.