internal/functions/Get-CommandMetaData.ps1
|
function Get-CommandMetaData { <# .SYNOPSIS Processes extra meta-information for a command .DESCRIPTION Processes extra meta-information for a command .PARAMETER CommandName The command to add information for. .PARAMETER File The file the command was read from .EXAMPLE PS C:\> Get-CommandMetaData -CommandName 'Get-Help' Adds additional information for Get-Help and returns a useful data object. #> [CmdletBinding()] param ( [Parameter(Mandatory = $true, ValueFromPipeline = $true)] [string[]] $CommandName, [string] $File ) begin { Write-PSFMessage -Level InternalComment -Message "Bound parameters: $($PSBoundParameters.Keys -join ", ")" -Tag 'debug', 'start', 'param' if (-not $script:allcommands) { # Cache known commands once Write-PSFMessage -Level Verbose -Message "Gathering command information" $script:allcommands = Get-Command | Group-Object Name | ForEach-Object { $_.Group | Sort-Object Version -Descending | Select-Object -First 1 } } } process { foreach ($command in $CommandName) { Write-PSFMessage -Level Verbose -Message "Adding meta information for: $($command)" $commandObject = [pscustomobject]@{ PSTypeName = 'JEAnalyzer.CommandInfo' CommandName = $command CommandObject = $script:allcommands | Where-Object Name -EQ $command File = $File } $commandObject | Select-PSFObject -KeepInputObject -ScriptProperty @{ IsAlias = { $this.CommandObject.CommandType -like 'Alias' } CommandType = { $this.CommandObject.CommandType } IsDangerous = { if ($this.CommandObject.Parameters.Values | Where-Object { $_.ParameterType.FullName -eq 'System.Management.Automation.ScriptBlock' }) { return $true } (& (Get-Module JEAnalyzer) { $script:dangerousCommands }) -contains $this.CommandName } Module = { $this.CommandObject.ModuleName } } -TypeName 'JEAnalyzer.CommandInfo' } } } |