Functions/Misc/Get-ibPSVersion.ps1
|
function Get-ibPSVersion { <# .SYNOPSIS Checks the version of ibPS, with the option to update if a version is available .DESCRIPTION This function is used check the current version of ibPS, with the option to check for updates and update if a version is available .PARAMETER CheckForUpdates This switch indicates you want to check for new versions .PARAMETER Update This switch will perform an upgrade if one is available .PARAMETER Details This switch will return installation details, such as module location and install type .PARAMETER Cleanup This switch will remove all except the latest version of ibPS automatically. Best to run as Administrator to avoid permissions issues if modules are installed globally. .PARAMETER Force This switch will force an update, whether or not one is available .EXAMPLE Get-ibPSVersion .EXAMPLE Get-ibPSVersion -CheckForUpdates .EXAMPLE Get-ibPSVersion -Update .FUNCTIONALITY ibPS #> param ( [Switch]$Details, [Switch]$CheckForUpdates, [Switch]$Update, [Switch]$Cleanup, [Switch]$Force ) $InstalledModule = Get-Module -ListAvailable -Name ibPS if (($InstalledModule).Path.Count -gt 1) { Write-Host "There is more than one version of ibPS installed on this computer. Please remove unneccessary older versions to avoid issues." -ForegroundColor Yellow Write-Host "You can run: 'Get-ibPSVersion -Cleanup' to perform this for you." -ForegroundColor Yellow Write-Host "Installed Versions: " -ForegroundColor Red $InstalledModule | Select-Object Version,Name,Description,ModuleBase | Format-Table -AutoSize if ($Cleanup) { $ModulesToRemove = $InstalledModule | Sort-Object Version -Descending | Select-Object -Skip 1 Write-Host "ibPS versions to remove: " -ForegroundColor Red $ModulesToRemove | Select-Object Version,Name,Description,ModuleBase | Format-Table -AutoSize Write-Warning "Confirmation: Do you want to proceed with removing old versions of ibPS?" -WarningAction Inquire foreach ($ModuleToRemove in $ModulesToRemove) { Remove-Item $($ModuleToRemove.ModuleBase) -Recurse -Force -EA SilentlyContinue -WA SilentlyContinue } Write-Host "Cleanup Complete." -ForegroundColor Green } else { $MultipleVersions = $true } $InstalledModule = $InstalledModule | Sort-Object Version -Descending | Select-Object -First 1 } else { if ($Cleanup) { Write-Host "There were no old ibPS Versions identified for cleanup." -ForegroundColor Green } } $PSGalleryModule = Get-InstalledModule -Name ibPS -EA SilentlyContinue -WA SilentlyContinue if ($PSGalleryModule) { [System.Version]$CurrentVersion = $PSGalleryModule.Version.ToString() } else { [System.Version]$CurrentVersion = $InstalledModule.Version.ToString() } $Build = Get-Content "$($($InstalledModule).ModuleBase)/Functions/Misc/build.json" | ConvertFrom-Json if ($Build.Branch) { $Branch = $Build.Branch } else { $Branch = 'main' } if ($CheckForUpdates -or $Update) { if ($PSGalleryModule) { [System.Version]$LatestVersion = (Find-Module -Name ibPS | Where-Object {$_.CompanyName -eq "TehMuffinMoo"}).Version.ToString() if (($LatestVersion -gt $CurrentVersion) -or $Force) { if ($Force) { Write-Host "Forcing update. Current Version: $($CurrentVersion) - Latest Version: $($LatestVersion)" -BackgroundColor DarkRed -ForegroundColor Yellow Update-Module ibPS -Force } else { Write-Host "New version available! Current Version: $($CurrentVersion) - Latest Version: $($LatestVersion)" -BackgroundColor Yellow -ForegroundColor DarkGreen if ($Update) { Update-Module ibPS } } } else { Write-Host "ibPS is up to date! Current Version: $CurrentVersion - Latest Version: $LatestVersion" -BackgroundColor Green -ForegroundColor Blue } } else { $ModuleManifest = Invoke-WebRequest -Uri "https://raw.githubusercontent.com/TehMuffinMoo/ibPS/$($Branch)/Modules/ibPS/ibPS.psd1" -Headers @{"Cache-Control"="no-cache"} if ($ModuleManifest) { [System.Version]$LatestVersion = ($ModuleManifest.RawContent | Select-String -Pattern 'ModuleVersion\s\=\s(.*)').Matches.Groups[1].Value -replace "'","" if (($LatestVersion -gt $CurrentVersion) -or $Force) { if ($Force) { Write-Host "Forcing update. Current Version: $($CurrentVersion) - Latest Version: $($LatestVersion)" -BackgroundColor DarkRed -ForegroundColor Yellow } else { Write-Host "New version available! Current Version: $($CurrentVersion) - Latest Version: $($LatestVersion)" -BackgroundColor Yellow -ForegroundColor DarkGreen } if ($Update) { Write-Warning "Confirmation: Do you want to proceed with updating from v$($CurrentVersion) to v$($LatestVersion)?" -WarningAction Inquire Invoke-WebRequest -Uri "https://github.com/TehMuffinMoo/ibPS/archive/refs/heads/$($Branch).zip" -OutFile ibPS.zip -Headers @{"Cache-Control"="no-cache"} if (Test-Path ibPS.zip) { Expand-Archive ibPS.zip } if (Test-Path ibPS) { $ModulePath = $InstalledModule.Path $Platform = Detect-OS if ($Platform -eq "Windows") { if ($ModulePath -like "$ENV:USERPROFILE\*") { $Selection = "i" } elseif ($ModulePath -like "C:\Windows\System32\WindowsPowerShell\*") { $Selection = "g" } } if ($Platform -eq "Mac" -or $Platform -eq "Unix") { if ($ModulePath -like "$($ENV:HOME)/*") { $Selection = "i" } elseif ($ModulePath -like "/usr/local/*") { $Selection = "g" } } Set-Location ibPS/ibPS-$($Branch) .\Install.ps1 -Selection $Selection } Set-Location ../../ Remove-Item ibPS,ibPS.zip -Recurse -Force if (((Get-Module -ListAvailable -Name ibPS).Version -eq $LatestVersion)) { Write-Host "Successfully updated ibPS to latest version: $LatestVersion" -ForegroundColor Green } else { Write-Error "Failed to update ibPS to latest version. Current Version: $CurrentVersion" } } } else { Write-Host "ibPS is up to date! Current Version: $CurrentVersion - Latest Version: $LatestVersion" -BackgroundColor Green -ForegroundColor Blue } } else { Write-Error "Unable to retrieve latest version information from Github." } } } else { if (!($MultipleVersions)) { if ($Details) { return @{ "Branch" = $Branch "Version" = $CurrentVersion.ToString() "Install Type" = $(if ($PSGalleryModule) { "Powershell Gallery" } else { "Local"}) "Install Path" = $InstalledModule.Path } | ConvertTo-Json | ConvertFrom-Json | Select-Object "Branch","Version","Install Type","Install Path" } else { return $($CurrentVersion.ToString()) } } } } |