Public/Find-InstalledModule.ps1
|
using namespace System.IO function Find-InstalledModule { # .SYNOPSIS # Find modules installed on your machine based on scope, version, name, etc. # .DESCRIPTION # Its like using Get-InstalledModule but you can even find unregistered/"manually Installed" modules. (as long as they are in any of $env:PSModulePath folders) # .EXAMPLE # Find-InstalledModule psake | Select-Object -Expand Path | Import-Module -Verbose # .NOTES # By default the cmdlet will search for the highest version from the specified scope. # If you want all versions, use -All switch [CmdletBinding(DefaultParameterSetName = 'n')] [OutputType([LocalPsModule[]])] param ( # The name of the module to search for. [Parameter(Position = 0, Mandatory = $false, ParameterSetName = '__AllParameterSets')] [Alias('n')][ValidateNotNullOrWhiteSpace()] [ArgumentCompleter({ [OutputType([System.Management.Automation.CompletionResult])] param( [string] $CommandName, [string] $ParameterName, [string] $WordToComplete, [System.Management.Automation.Language.CommandAst] $CommandAst, [System.Collections.IDictionary] $FakeBoundParameters ) $CompletionResults = [System.Collections.Generic.List[CompletionResult]]::new() $matchingNames = [LocalPsModule]::new().GetValidValues().Where({ $_ -like "$WordToComplete*" }) foreach ($n in $matchingNames) { $CompletionResults.Add([System.Management.Automation.CompletionResult]::new($n)) } return $CompletionResults })] [string]$Name, # The scope of the module (LocalMachine or CurrentUser). # If you don't use this parameter then, this cmdlet uses LocalMachine as a default scope. [Parameter(Position = 1, Mandatory = $false, ParameterSetName = 'n')] [Alias('s')][ValidateSet("LocalMachine", "CurrentUser")] [string]$Scope = "LocalMachine", # The version of the module to search for. [Parameter(Position = 2, Mandatory = $false, ParameterSetName = 'n')] [Alias('v')] [Version]$Version, # The directory to search within for the module. [Parameter(Position = 1, Mandatory = $false, ParameterSetName = 'b')] [Alias('base', 'b')] [IO.DirectoryInfo]$ModuleBase, # All versions, even duplicates. [switch]$All ) begin { $res = $null $hsn = $PSBoundParameters.ContainsKey('Name') $hsv = $PSBoundParameters.ContainsKey('Version') $hsm = $PSBoundParameters.ContainsKey('ModuleBase') $hss = $PSBoundParameters.ContainsKey('Scope') } process { try { $res = switch ($true) { $($hsn -and $hss -and $hsv) { [LocalPsModule]::Find($Name, $Scope, $Version); break } $($hsn -and $hss) { [LocalPsModule]::Find($Name, $Scope); break } $($hsn -and $hsv) { [LocalPsModule]::Find($Name, $Version); break } $($hsm -and $hsn) { [LocalPsModule]::Find($Name, $ModuleBase); break } $hsn { [LocalPsModule]::Find($Name); break } $hsm { [LocalPsModule]::Find($ModuleBase.FullName); break } Default { [LocalPsModule]::Find("*") } } } catch { $PSCmdlet.WriteError($_) } } end { if ($res) { return $res } else { Write-Verbose "No module found matching the specified criteria." } } } |