Functions/Get-Power.ps1
|
function Get-Power { <# .SYNOPSIS Provides exponentian .DESCRIPTION Provides exponentian, also called power as in "2 to the power 3" equals 8 .PARAMETER Base The base number that will be raised to a power .PARAMETER Power To what level the exponentian will go. Defaults to 1. .PARAMETER IncludeOriginal A switch to determine if you want the input parameters to be included in the output .NOTES To do square or cube roots invert the power. square root, -Power (1/2) cube root, -Power (1/3) and so on. .EXAMPLE Get-Power -Base 2 -Power 3 Returns 8 .EXAMPLE Get-Power -Base 2 -Power 10 Returns 1024 .EXAMPLE Get-Power -Base 4 -Power 0.5 Returns 2 .EXAMPLE .OUTPUTS [double] .LINK #> #region parameter [CmdletBinding(ConfirmImpact='Low')] [OutputType('double')] Param ( [parameter(Mandatory,HelpMessage='Enter the base number you wish to be exponentiated',Position=0,ValueFromPipeline)] [double[]] $Base, [parameter(Position=1)] [double] $Power = 1, [switch] $IncludeOriginal ) #endregion parameter begin { } process { foreach ($currentNumber in $Base) { $ReturnVal = [double] [math]::Pow($currentNumber,$Power) if ($IncludeOriginal) { New-Object -TypeName 'psobject' -Property ([ordered] @{ Base = $currentNumber Power = $Power Result = $ReturnVal }) } else { $ReturnVal } } } end { } } |