Handles switching Terraform versions in Windows.

• Terraform already existing and usable.
• Create a folder named previous inside the folder where the existing Terraform executable is located.
• Update the folling variables in the all .ps1 files with the corresponing folder paths unique to your workstation.
  • $terraformPath - Example: $terraformPath = "C:\Users\user1\Documents\terraform\"
  • $tfswitcherPath - Example: $tfswitcherPath = "C:\Users\user1\Documents\Code\tools\tfswitcher\"
• Add the following code to your PowerShell profile¹. Ensure you change the directory to point to where the functions are going to run execute from.

¹ Sometimes the $Profile mentiones that a profile file exist but this may not be true and you may need to create one.

# Load tfswitcher custom functions
$tfswitcher = "$env:USERPROFILE\Documents\tools\tfswitcher" #### Change Me
Write-Host "Loading tfswitcher functions." -ForegroundColor Green
Write-Host "tfswitcher-download" -ForegroundColor Yellow
Write-Host "tfswitcher-localver" -ForegroundColor Yellow
Write-Host "tfswitcher-switchver" -ForegroundColor Yellow
Write-Host "tfswitcher-undo" -ForegroundColor Yellow
Write-Host "tfswitcher-help" -ForegroundColor Yellow
Get-ChildItem "$tfswitcher\*.ps1" | % { .$_ }
Write-Host ''

This function downloads Terraform version to populate your tfswitch folder. Once the version are located and formated in the tfswitch folder they can be used.

This function list existing avialble Terraform versions that can be used by the tfswitcher-switchver function.

This function changes the existing Terraform into any avialble version.

This function reverts to the last Terraform version used. This function can be executed after a tfswitcher-switchver to revert to the previous Terraform version in use. :exclamation: This function reverts only if at least one sucessfull tfswitcher-switchver has occured. Until then the previous folder will be empty and thus there will not be a version to revert too.

This function simply list the available functions, it helps when you are new to using tfswitcher.

Run only scripts that you trust. While scripts from the internet can be useful, this script can potentially harm your computer. If you trust this script, use the Unblock-File cmdlet to allow the script to run without this warning message. Do you want to run C:\Users\user1\Documents\tools\tfswitcher\tfswitcher-download.ps1? [D] Do not run [R] Run once [S] Suspend [?] Help (default is "D"):

This warning will occur for every .ps1 that the profile is trying to load. The solution is to navigate to the path where the .ps1 scripts exist and unblock them. This is how I like to do it.

C:\Users\user1\Documents\tools\tfswitcher\ls | unblock-file

This will unblock all of them at once. Ensure all PowerShell sessions have been closed. The next time you open a PowerShell session the profile will load them without any warnings.