Functions/ConvertFrom-HtmlEncode.ps1
|
function ConvertFrom-HtmlEncode { <# .SYNOPSIS Converts a URL encoded string back into a normal string .DESCRIPTION Converts a HTML encoded string back into a normal string .PARAMETER HTML The encoded HTML 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-HTMLEncode -HTML '&' -IncludeInput HtmlEncoded PlainText ----------- --------- & & .OUTPUTS [string] .NOTES Inspired by: https://community.idera.com/database-tools/powershell/powertips/b/tips/posts/html-encoding #> [CmdletBinding(ConfirmImpact = 'None')] [OutputType('string')] Param( [Parameter(ValueFromPipeline)] [string[]] $HTML, [Alias('IncludeOriginal')] [switch] $IncludeInput ) begin { Write-Verbose -Message "Starting [$($MyInvocation.Mycommand)]" } process { foreach ($currentHTML in $HTML) { $Decode = [System.Web.HttpUtility]::HtmlDecode($currentHTML) if ($IncludeInput) { New-Object -TypeName 'psobject' -Property ([ordered] @{ HtmlEncoded = $currentHTML PlainText = $Decode }) } else { Write-Output -InputObject $Decode } } } end { Write-Verbose -Message "Ending [$($MyInvocation.Mycommand)]" } } |