Functions/Install-PsModuleFast.ps1
|
<#
.SYNOPSIS Installs and Imports a module .DESCRIPTION Encapsulates the logic to ensure the required version is installed and loaded into the session. If not installed the module is downloaded to the CurrentUser scope. If a version that isn't compatible is loaded it will be removed If the version required isn't loaded it will be imported You can specify, ```-MinimumVersion```, ```-MaximumVersion``` in which case an appropriate version is loaded if installed. It will not go and install a later version even if one exists in the repository unless `-latest` is used If required version is specified only that version will be installed and imported . .EXAMPLE none .OUTPUTS none .NOTES none #> Function Install-PsModuleFast { [CmdletBinding()] param([string] #Name of the module to install $module , #Minimum version to install and import [version] $version #Maximumversion to install and import , [version] $MaxVersion #The version that has to be found to install. Must be 3 part version number , [string] $RequiredVersion #Allows for pre release versions to be installed , [switch] $AllowPrerelease #Repository to look for modules , [string] $Repository #Will find the latest version within the Min and Max specified and install that ,[switch]$Latest ,[string]$Scope="CurrentUser") if ($PSBoundParameters.ContainsKey("RequiredVersion") ){ split-version $requiredVersion |out-null } Write-Verbose "Loading module $Module" Repair-PSModulePath; if ($Latest){ $FindModuleArgs = @{Name=$Module} if ($version){$FindModuleArgs.Add("MinimumVersion",$version)} if ($MaxVersion){$FindModuleArgs.Add("MaximumVersion",$MaxVersion)} if ( $Repository){ $FindModuleArgs.Add("Repository",$Repository)} Write-Verbose "Finding Latest version for module" $RequiredVersion = (Find-Module @FindModuleArgs).Version Write-Verbose "Latest version found $RequiredVersion " } $InstallmoduleArgs = @{} if ($Repository) { $InstallmoduleArgs.Add("Repository", $Repository) } $VersionArgs = @{} if ($RequiredVersion) { $versionparts = split-version $RequiredVersion Write-Verbose "Only using Required Version $($versionparts.version) prerelease $($versionparts.prerelease)" $VersionArgs.Add("RequiredVersion", $RequiredVersion) # $VersionArgs.Add("prerelease", $versionparts.Prerelease) } else{ if ($Version) { $VersionArgs.Add("MinimumVersion", $Version) } if ($MaxVersion) { $VersionArgs.Add("MaximumVersion", $MaxVersion) } } if (Test-ShouldInstallModule -Module $Module @VersionArgs) { Write-Host " Installing module $module" -NoNewline if ((get-module powershellget).version -ge [version]"1.6.0"){ $InstallmoduleArgs.Add("AllowPrerelease",$AllowPrerelease) } elseif ($AllowPrerelease){ throw "Can't use prelease versions with Powershellget version < 1.6.0" } install-module $module -force -AllowClobber -Scope $Scope -SkipPublisherCheck @InstallmoduleArgs @VersionArgs # -ErrorAction $ErrorActionPreference Write-Host " - installed $((get-module $module -ListAvailable).Version)" } if (Test-ShouldImportModule -module $module @VersionArgs) { Write-Host " importing module $module " -NoNewline #remove module from session get-Module $module | ForEach-Object{ Write-Host " - removing $($_.version)" -NoNewline remove-module -Name $_.name -Verbose } #import module doesn't understand prerelease if ($RequiredVersion) { $versionparts = split-version $RequiredVersion Write-Verbose "Only using Required Version" $VersionArgs.RequiredVersion=$versionparts.Version } import-module $module -force @VersionArgs -Global -Verbose:$VerbosePreference #-ErrorAction $ErrorActionPreference Write-Host " - imported $((get-module $module).Version)" } Write-Host ("using module {0:-20} - {1}" -f $module, $($(Get-Module $module).version)) } function Test-ShouldImportModule() { [CmdletBinding()] [OutputType([Boolean])] param($module , [string]$RequiredVersion , [version]$MaximumVersion , [version]$MinimumVersion) $modulesLoaded = get-module $module return Test-ShouldGetVersion -modules $modulesLoaded -RequiredVersion $RequiredVersion -MinimumVersion $MinimumVersion -MaximumVersion $MaximumVersion } # Function Install-PsModuleFast { # [CmdletBinding()] # param([string] $module # , [version] $version # , [parameter(Mandatory=$false)][string] $path) # # Repair-PSModulePath; # # Write-Verbose "Loading module $Module" # if (-not (get-module $(join-path $path $module) -ListAvailable | Where-object Version -ge $version)) { # Write-Output " Installing module $module" # if ($null -eq $version) { # install-module $module -path $path -force -AllowClobber -Scope CurrentUser -SkipPublisherCheck # } # else { # install-module $module -path $path -force -AllowClobber -Scope CurrentUser -SkipPublisherCheck -MinimumVersion $version # } # } # # if (-not (get-module $module | Where-object Version -GE $version)) { # Write-Output " importing module $module $version" # if ($null -eq $version ) { # import-module $module -force # } # else { # import-module $module -force -MinimumVersion $version # } # } # } # $PSModules = @{Module = "Pester"; Version = "4.5" }, ` # @{Module = "Microsoft.PowerApps.PowerShell" }, ` # @{Module = "Microsoft.PowerApps.Administration.PowerShell" }, ` # @{Module = "VSSetup" } # foreach ($Ps in $PSModules) { # # Install-PsModuleFast @PS # } |