Functions/ConvertTo-UrlEncode.ps1
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 |
function ConvertTo-UrlEncode { <# .SYNOPSIS To encode plaintext using [Web.HttpUtility]::UrlEncode() .DESCRIPTION To encode plaintext using [Web.HttpUtility]::UrlEncode() .PARAMETER URL The original text that you want encoded. Can be a string or an array of strings. Accepts pipeline input. .PARAMETER IncludeInput A switch to determine if you want original text in the output. Aliased to 'IncludeOriginal' for backward compatibility of scripts .EXAMPLE ConvertTo-UrlEncode -URL https://www.google.com/ Would return https%3a%2f%2fwww.google.com%2f .EXAMPLE ConvertTo-UrlEncode -URL https://www.google.com/ -IncludeInput Would return PlainText Encoded --------- ------- https://www.google.com/ https%3a%2f%2fwww.google.com%2f #> [CmdletBinding()] [alias('UrlEncode')] param( [Parameter(ValueFromPipeline)] [string[]] $URL, [Alias('IncludeOriginal')] [switch] $IncludeInput ) begin { Write-Verbose -Message "Starting [$($MyInvocation.Mycommand)]" } process { foreach ($currentURL in $URL) { $Encode = [Web.HttpUtility]::UrlEncode($currentURL) if ($IncludeInput) { New-Object -TypeName 'psobject' -Property ([ordered] @{ PlainText = $currentURL Encoded = $Encode }) } else { Write-Output -InputObject $Encode } } } end { Write-Verbose -Message "Ending [$($MyInvocation.Mycommand)]" } } |