functions/Get-Parameter.ps1
|
Function Get-ParameterInfo { [cmdletbinding()] [Outputtype("PSParameterInfo")] [alias("gpi")] Param( [Parameter( Position = 0, Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName, HelpMessage = "Enter a cmdlet name" )] [ValidateNotNullorEmpty()] [Alias("name")] [string]$Command, [string]$Parameter ) Begin { Write-Verbose "Starting $($myinvocation.MyCommand)" #define the set of common parameters to exclude $common = @("Verbose", "Debug", "ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable", "OutVariable", "OutBuffer", "WhatIf", "Confirm", "InformationAction", "InformationVariable", "PipelineVariable" ) } #begin Process { Write-Verbose "Processing $command for parameter information" Try { #need to account that the command might be an alias (Issue #101). 1/21/2021 JDH $cmd = Get-Command -name $command -ErrorAction Stop if ($cmd.CommandType -eq 'alias') { Write-Verbose "Resolving the alias $Command to $($cmd.ResolvedCommand)" $data = (Get-Command -Name $cmd.ResolvedCommand -ErrorAction "Stop").parameters } else { $data = $cmd.parameters } } Catch { Write-Warning "Failed to find command $command" } # keep going if parameters were found # Explicitly calling base, to prevent .count from being shadowed # if ($data.psbase.Count -gt 0) { #$data is a hash table if ($Parameter) { Write-Verbose "Getting parameter $Parameter" if ($data.ContainsKey( $Parameter)) { $params = $Parameter } else { Throw "Can't find a parameter called $Parameter." } } else { Write-Verbose 'Getting parameter all non-common parameters' $params = $data.keys | Where-Object { $common -notcontains $_ } } $count = ($params | Measure-Object).count #only keep going if non-common parameters were found Write-Verbose "Found $count non-common parameters for $command" if ($count -gt 0) { #get information from each parameter $params | ForEach-Object { $name = $_ Write-Verbose "Analyzing $name" $type = $data.item($name).ParameterType $aliases = $data.item($name).Aliases -join ',' $sets = $data.item($name).ParameterSets.Keys $IsDynamic = $data.item($name).IsDynamic foreach ($set in $sets) { #retrieve parameter attribute class $attributes = $data.item($name).Attributes | Where-Object { $_ -is [system.management.automation.parameterAttribute] -AND $_.ParameterSetName -eq $set } #a parameter could have different positions in different property sets if ($attributes.position -ge 0) { $position = $attributes.position } else { $position = 'Named' } #write a custom object to the pipeline [PSCustomObject]@{ PSTypeName = 'PSParameterInfo' Name = $name Aliases = $aliases Mandatory = $attributes.mandatory Position = $position ValueFromPipeline = $attributes.ValueFromPipeline ValueFromPipelineByPropertyName = $attributes.ValueFromPipelineByPropertyName Type = $type IsDynamic = $IsDynamic ParameterSet = $attributes.ParameterSetName } } #foreach set } #foreach object } #if $count } #if $data else { Write-Warning "$command has no defined parameters" } } #process End { Write-Verbose "Ending $($myinvocation.MyCommand)" } #end } #end function |