Public/Get-PowerShellPortable.ps1
|
function Get-PowerShellPortable { <# .SYNOPSIS Download a portable version of PowerShell to run anywhere on demand. .DESCRIPTION This function helps you download a zipped version of PowerShell 7.x that can be run anywhere without needing to install it. .PARAMETER Path The path (directory) to download the PowerShell zip or tar.gz file into. Do not include a filename for the download. .PARAMETER Extract Extract the downloaded file. .EXAMPLE Get-PowerShellPortable -Path $HOME -Extract Download the latest ZIP/TAR of PowerShell to your $HOME folder. It will be extracted into a folder that matches the filename of the compressed archive. .NOTES Author: Sam Erde Version: 0.1.0 Modified: 2024/10/12 #> [CmdletBinding(HelpUri = 'https://day3bits.com/PSPreworkout/Get-PowerShellPortable')] [Alias('Get-PSPortable')] param ( # Path to download and extract PowerShell to [Parameter()] [string] $Path, # Extract the file after downloading [Parameter()] [switch] $Extract ) #region Determine Download Uri # Get the zip and tar.gz PowerShell download links for Windows, macOS, and Linux. #$ApiUrl = 'https://api.github.com/repos/PowerShell/PowerShell/releases/tags/v7.4.5' #$Response = Invoke-RestMethod -Uri $ApiUrl -Headers @{ 'User-Agent' = 'PowerShellScript' } #$Assets = $Response.assets #$DownloadLinks = $Assets | Where-Object { $_.browser_download_url -match '\.zip$|\.tar\.gz$' } | Select-Object -ExpandProperty browser_download_url $DownloadLinks = (Invoke-RestMethod -Uri 'https://api.github.com/repos/PowerShell/PowerShell/releases/latest').assets.browser_download_url # Determine the platform and architecture $Architecture = [System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture # OSArchitecture isn't present in older versions of .NET Framework, so use the environment variable as a fallback for Windows. if (-not $Architecture) { $Architecture = $([System.Environment]::GetEnvironmentVariable('PROCESSOR_ARCHITECTURE')).Replace('AMD64', 'X64') } # Set the pattern for the ZIP file based on the OS and architecture $FilePattern = if ( [System.Runtime.InteropServices.RuntimeInformation]::IsOSPlatform([System.Runtime.InteropServices.OSPlatform]::Windows) ) { "win-$Architecture.zip" } elseif ( [System.Runtime.InteropServices.RuntimeInformation]::IsOSPlatform([System.Runtime.InteropServices.OSPlatform]::Linux) ) { "linux-$Architecture.tar.gz" } elseif ( [System.Runtime.InteropServices.RuntimeInformation]::IsOSPlatform([System.Runtime.InteropServices.OSPlatform]::OSX) ) { "osx-$Architecture.tar.gz" } else { throw "Operating system unknown: $($PSVersionTable.OS)." return } $DownloadUrl = $DownloadLinks | Where-Object { $_ -match $FilePattern } $FileName = ($DownloadUrl -split '/')[-1] if (-not $PSBoundParameters.ContainsKey('Path')) { $Path = [System.IO.Path]::Combine($HOME, 'Downloads') } else { # Resolves an issue with ~ not resolving properly in the script during the file extraction steps. $Path = Resolve-Path $Path } $OutFilePath = [System.IO.Path]::Combine($Path, $FileName) $PwshDirectory = "$([System.IO.Path]::GetFileNameWithoutExtension($OutFilePath) -replace [Regex]'\.zip$|\.tar.gz$|\.gz$|\.tar$', '')" if (-not (Test-Path (Join-Path -Path $Path -ChildPath $PwshDirectory))) { try { New-Item -Name $PwshDirectory -Path $Path -ItemType Directory } catch { Write-Warning "Unable to create the directory $PwshDirectory in $Path." } } $PwshPath = Join-Path -Path $Path -ChildPath $PwshDirectory #endregion Determine Download Uri #region Download PowerShell try { Invoke-WebRequest -Uri $DownloadUrl -OutFile $OutFilePath Write-Output "PowerShell has been downloaded to $OutFilePath." } catch { Write-Error "Failed to download $DownloadUrl to $Path." $_ return } #endregion Download PowerShell Unblock-File -Path $OutFilePath #region Extract PowerShell if ($PSBoundParameters.ContainsKey('Extract')) { if ($IsLinux) { # Decompress the GZip file $GZipFile = $OutFilePath $TarFile = $GZipFile -replace '\.gz$', '' [System.IO.Compression.GzipStream]::new( [System.IO.FileStream]::new($GZipFile, [System.IO.FileMode]::Open), [System.IO.Compression.CompressionMode]::Decompress ).CopyTo( [System.IO.FileStream]::new($TarFile, [System.IO.FileMode]::Create) ) # Use tar command to extract the .tar file tar -xf $tarFile -C $PwshPath Write-Output "PowerShell has been extracted to $PwshPath." } if ($IsMacOS) { # Decompress the tar and GZip file $GZipFile = $OutFilePath $TarFile = $GZipFile -replace '\.gz$', '' [System.IO.Compression.GzipStream]::new( [System.IO.FileStream]::new($GZipFile, [System.IO.FileMode]::Open), [System.IO.Compression.CompressionMode]::Decompress ).CopyTo( [System.IO.FileStream]::new($TarFile, [System.IO.FileMode]::Create) ) # Use tar command to extract the .tar file tar -xzf $GzipFile -C $PwshPath Write-Output "PowerShell has been extracted to $PwshPath." } if (-not $IsLinux -and -not $IsMacOS) { # Windows try { # Expand the zip file into a folder that matches the zip filename without the zip extenstion if (Test-Path -PathType Container -Path (Join-Path -Path $Path -ChildPath $PwshDirectory)) { Expand-Archive -Path $OutFilePath -DestinationPath (Join-Path -Path $Path -ChildPath $PwshDirectory) -Force Write-Information -MessageData "PowerShell has been extracted to $PwshPath" -InformationAction Continue Write-Information -MessageData "Run '$PwshPath\pwsh.exe' to launch the latest version of PowerShell without installing it!" -InformationAction Continue } else { Write-Warning -Message "The target folder $Path\$Pwshdirectory does not exist." -WarningAction Stop } } catch { Write-Error "Failed to expand the archive $OutFilePath." $_ } } } # end if Extract #endregion Extract PowerShell } # end function Get-PowerShellPortable |