Cleanup old module versions when upgrading powershell modules and --cleanup is specified

[soredake]

I want to suggest a new step

• Which tool is this about? Where is its repository?
• Which operating systems are supported by this tool?
• What should Topgrade do to figure out if the tool needs to be invoked?
• Which exact commands should Topgrade run?
• Does it have a --dry-run option? i.e., print what should be done and exit
• Does it need the user to confirm the execution? And does it provide a --yes
  option to skip this step?

I want to suggest some general feature

Cleanup old module versions when upgrading powershell modules and --cleanup is specified, example powershell function to do this:

function Remove-OldModule {
  [CmdletBinding(SupportsShouldProcess)]
  param ()

  $Latest = Get-InstalledModule

  foreach ($module in $Latest) {
    $oldVersions = Get-InstalledModule -Name $module.Name -AllVersions | Where-Object { $_.Version -ne $module.Version }

    foreach ($oldVersion in $oldVersions) {
      if ($PSCmdlet.ShouldProcess("Module: $($module.Name) Version: $($oldVersion.Version)", "Uninstall")) {
        Uninstall-Module -Name $module.Name -RequiredVersion $oldVersion.Version -Verbose
      }
    }
  }
}

More information

https://luke.geek.nz/2021/06/18/remove-old-powershell-modules-versions-using-powershell/