Dark Mode
<#
.SYNOPSIS
Returns the scope of an installed module.
.FUNCTIONALITY
PowerShell Modules
.INPUTS
System.Object with a "Name" or "ModuleName" property containing a module name.
.OUTPUTS
System.Management.Automation.PSObject with the following properties:
* ModuleName: The name of the module.
* Scope: The value "CurrentUser" if the module is found within $HOME\Documents\PowerShell\Modules, "AllUsers" if found anywhere else.
.EXAMPLE
Get-ModuleScope.ps1 Detextive
ModuleName Scope
---------- -----
Detextive CurrentUser
.EXAMPLE
Get-ModuleScope.ps1 Pester
ModuleName Scope
---------- -----
Pester CurrentUser
Pester AllUsers
#>
#Requires -Version 7
[CmdletBinding()][OutputType([string])] Param(
# Specifies names or name patterns of modules that this cmdlet gets. Wildcard characters are permitted.
[Parameter(Position=0,ValueFromPipelineByPropertyName=$true) ][Alias('ModuleName')][string] $Name = '*'
)
Begin
{
$UserRoot = Join-Path $HOME Documents PowerShell Modules
}
Process
{
foreach($moduleName in Get-Module $Name -ListAvailable |Select-Object -ExpandProperty Name -Unique)
{
Get-Module $moduleName -ListAvailable |
Select-Object -ExpandProperty ModuleBase |
Split-Path |
Split-Path |
Select-Object -Unique |
ForEach-Object {$_ -eq $UserRoot ? 'CurrentUser' : 'AllUsers'} |
Select-Object -Unique |
ForEach-Object {[pscustomobject]@{ModuleName=$moduleName;Scope=$_}}
}
}