✨ Add outdated modules script; update other module management

Author: brianary

Get-OutdatedModules.ps1

@@ -0,0 +1,35 @@
+<#
+.SYNOPSIS
+Returns a list of modules that have upgrades available.
+
+.FUNCTIONALITY
+PowerShell Modules
+
+.LINK
+Get-ModuleScope.ps1
+
+.EXAMPLE
+Get-OutdatedModules.ps1
+
+Name       Scope    CurrentVersion  AvailableVersion
+---------- -------- --------------- ----------------
+PSReadLine AllUsers 2.3.6           2.4.5
+ThreadJob  AllUsers 2.0.7           2.1.0
+#>
+
+#Requires -Version 7
+[CmdletBinding()] Param()
+Get-Module -ListAvailable |
+    Group-Object Name |
+    ForEach-Object -Parallel {
+        $name, $group = $_.Name, $_.Group
+        try
+        {[pscustomobject]@{
+            Name             = $name
+            Scope            = Get-ModuleScope.ps1 $name |Select-Object -ExpandProperty Scope
+            CurrentVersion   = $group |Measure-Object Version -Maximum |Select-Object -ExpandProperty Maximum
+            AvailableVersion = Find-Module $name -ErrorAction Stop |Select-Object -ExpandProperty Version
+        }}
+        catch{}
+    } |
+    Where-Object {$_.CurrentVersion -lt $_.AvailableVersion}

Show-Status.ps1

@@ -86,12 +86,7 @@ Begin
 
     function Get-PSModulesTest
     {{
-        if(Get-Module -ListAvailable |
-            ForEach-Object -Parallel {
-                Find-Module $_.Name -EA Ignore |
-                Where-Object Version -gt $_.Version
-            } -ThrottleLimit 6 |
-            Select-Object -First 1) {'psmodules'}
+        if(Get-OutdatedModules.ps1 |Select-Object -First 1) {'psmodules'}
     }}
 
     filter Format-Status

Uninstall-OldModules.ps1

@@ -1,18 +1,23 @@
 <#
 .SYNOPSIS
-Uninstalls old module versions.
+Uninstalls old module versions (ignoring old Windows PowerShell modules).
 
 .FUNCTIONALITY
 PowerShell Modules
+
+.EXAMPLE
+Uninstall-OldModules.ps1
+
+Cleans up redundant old modules.
 #>
 
 #Requires -Version 3
-[CmdletBinding(ConfirmImpact='High',SupportsShouldProcess=$true)][OutputType([void])] Param(
+[CmdletBinding(ConfirmImpact='High',SupportsShouldProcess=$true)] Param(
 # Indicates the modules should be forced to uninstall.
 [switch] $Force
 )
 
-Get-Module -List |
+Get-Module -ListAvailable |
 	Where-Object {$PSVersionTable.PSVersion -lt [version]'6.0' -or $_.ModuleBase -notlike '*\WindowsPowerShell\*'} |
 	Group-Object Name |
 	Where-Object Count -gt 1 |

Update-Modules.ps1

@@ -4,17 +4,17 @@ Cleans up old modules.
 
 .FUNCTIONALITY
 PowerShell Modules
+
+.LINK
+Uninstall-OldModules.ps1
+
+.EXAMPLE
+Update-Modules.ps1
+
+Updates installed modules and purges old versions.
 #>
 
 #Requires -Version 3
-[CmdletBinding()][OutputType([void])] Param()
-
+[CmdletBinding()] Param()
 Update-Module -Force
-foreach($module in Get-Module -List |Group-Object Name |Where-Object Count -gt 1)
-{
-	$newestversion = $module.Group.Version |Sort-Object -Descending |Select-Object -First 1
-	foreach($oldmodule in $module.Group |Where-Object Version -lt $newestversion)
-	{
-		Uninstall-Module $oldmodule.Name -RequiredVersion $oldmodule.Version
-	}
-}
+Uninstall-OldModules.ps1