Functions/ConvertFrom-UrlEncode.ps1
|
function ConvertFrom-UrlEncode { <# .SYNOPSIS Converts a URL encoded string back into a normal string .DESCRIPTION Converts a URL encoded string back into a normal string .PARAMETER URL The encoded URL string. Can be a string or an array of strings. Accepts pipeline input. .PARAMETER IncludeInput A switch to enable showing original text in the output. Aliased to 'IncludeOriginal' for backward compatibility of scripts .EXAMPLE ConvertFrom-UrlEncode -URL 'https%3a%2f%2fwww.google.com%2f' Would return https://www.google.com/ .EXAMPLE ConvertFrom-UrlEncode -URL 'https%3a%2f%2fbing.com' -IncludeInput Would return Encoded Decoded ------- ------- https%3a%2f%2fbing.com https://bing.com .EXAMPLE ConvertFrom-UrlEncode -URL 'https%3a%2f%2fbing.com', 'https%3a%2f%2fwww.google.com%2f' -IncludeInput Would return Encoded Decoded ------- ------- https%3a%2f%2fbing.com https://bing.com https%3a%2f%2fwww.google.com%2f https://www.google.com/ .OUTPUTS [string] #> [CmdletBinding(ConfirmImpact = 'None')] [OutputType('string')] Param( [Parameter(ValueFromPipeline)] [string[]] $URL, [Alias('IncludeOriginal')] [switch] $IncludeInput ) begin { Write-Verbose -Message "Starting [$($MyInvocation.Mycommand)]" } process { foreach ($currentURL in $URL) { $Decode = [System.Web.HttpUtility]::UrlDecode($currentURL) if ($IncludeInput) { New-Object -TypeName 'psobject' -Property ([ordered] @{ Encoded = $currentURL Decoded = $Decode }) } else { Write-Output -InputObject $Decode } } } end { Write-Verbose -Message "Ending [$($MyInvocation.Mycommand)]" } } Set-Alias -Name 'UrlDecode' -Value 'ConvertFrom-UrlEncode' -Description 'Alias for ConvertFrom-UrlEncode' |