Private/Invoke-EvergreenWebRequest.ps1

function Invoke-EvergreenWebRequest {
    <#
        .SYNOPSIS
            Validates and return responses from Invoke-WebRequest
            Enables normalisation for all public functions and across PowerShell/Windows PowerShell
            Some validation of $Uri is expected before passing to this function
    #>

    [OutputType([Microsoft.PowerShell.Commands.WebResponseObject])]
    [CmdletBinding(SupportsShouldProcess = $True)]
    param (
        [Parameter(Mandatory = $True, Position = 0)]
        [ValidateNotNullOrEmpty()]
        [System.String] $Uri,

        [Parameter()]
        [ValidateNotNullOrEmpty()]
        [System.String] $ContentType,

        [Parameter()]
        [ValidateNotNullOrEmpty()]
        [System.Collections.Hashtable] $Headers,

        [Parameter()]
        [ValidateSet("Default", "Get", "Head", "Post")]
        [System.String] $Method = "Default",

        [Parameter()]
        [ValidateSet("Default", "Tls", "Tls11", "Tls12", "Tls13")]
        [System.String] $SslProtocol = "Tls12",

        [Parameter()]
        [ValidateNotNullOrEmpty()]
        [System.String] $UserAgent = $script:resourceStrings.UserAgent.Base,

        [Parameter()]
        [System.Management.Automation.SwitchParameter] $Raw,

        [Parameter()]
        [System.Management.Automation.SwitchParameter] $SkipCertificateCheck,

        [Parameter()]
        [ValidateSet("Content", "RawContent", "Headers", "All")]
        [System.String] $ReturnObject = "Content"
    )

    # Disable the Invoke-WebRequest progress bar for faster downloads
    if ($PSBoundParameters.ContainsKey("Verbose")) {
        $ProgressPreference = [System.Management.Automation.ActionPreference]::Continue
    }
    else {
        $ProgressPreference = [System.Management.Automation.ActionPreference]::SilentlyContinue
    }

    # PowerShell 5.1: Trust certificate used by the remote server (typically self-sign certs)
    # PowerShell Core will use -SkipCertificateCheck
    if (($script:SkipCertificateCheck -eq $true -or $PSBoundParameters.ContainsKey("SkipCertificateCheck")) -and -not(Test-PSCore)) {
        Write-Verbose -Message "$($MyInvocation.MyCommand): Creating class TrustAllCertsPolicy."
        Add-Type @"
using System.Net;
using System.Security.Cryptography.X509Certificates;
public class TrustAllCertsPolicy : ICertificatePolicy {
    public bool CheckValidationResult(
        ServicePoint srvPoint, X509Certificate certificate,
        WebRequest request, int certificateProblem) {
        return true;
    }
}
"@

        Write-Verbose -Message "$($MyInvocation.MyCommand): Trust all certificates."        
        [System.Net.ServicePointManager]::CertificatePolicy = New-Object -TypeName "TrustAllCertsPolicy"
    }

    # Use TLS for connections
    [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072

    # Build the Invoke-WebRequest parameters
    $params = @{
        Uri             = $Uri
        Method          = $Method
        UserAgent       = $UserAgent
        UseBasicParsing = $true
    }

    # Set additional parameters
    if ($PSBoundParameters.ContainsKey("ContentType")) {
        Write-Verbose -Message "$($MyInvocation.MyCommand): Adding ContentType."
        $params.ContentType = $ContentType
    }
    if ($PSBoundParameters.ContainsKey("Headers")) {
        Write-Verbose -Message "$($MyInvocation.MyCommand): Adding Headers."
        $params.Headers = $Headers
    }
    if (($script:SkipCertificateCheck -eq $true -or $PSBoundParameters.ContainsKey("SkipCertificateCheck")) -and (Test-PSCore)) {
        Write-Verbose -Message "$($MyInvocation.MyCommand): Adding SkipCertificateCheck."
        $params.SkipCertificateCheck = $true
    }
    if ($PSBoundParameters.ContainsKey("SslProtocol") -and (Test-PSCore)) {
        Write-Verbose -Message "$($MyInvocation.MyCommand): Adding SslProtocol."
        $params.SslProtocol = $SslProtocol
    }
    if ($PSBoundParameters.ContainsKey("Raw")) {
        $tempFile = New-TemporaryFile -WhatIf:$WhatIfPreference
        $params.OutFile = $tempFile
        $params.PassThru = $True
        Write-Verbose -Message "$($MyInvocation.MyCommand): Using temp file $tempFile."
    }
    if (Test-ProxyEnv) {
        $params.Proxy = $script:EvergreenProxy
    }
    if (Test-ProxyEnv -Creds) {
        $params.ProxyCredential = $script:EvergreenProxyCreds
    }
    #endregion

    # Output the parameters when using -Verbose
    foreach ($item in $params.GetEnumerator()) {
        Write-Verbose -Message "$($MyInvocation.MyCommand): Invoke-WebRequest parameter: $($item.name): $($item.value)."
    }

    # Call Invoke-WebRequest
    try {
        if ($PSCmdlet.ShouldProcess($Uri, "Invoke-WebRequest")) {
            $Response = Invoke-WebRequest @params
        }
    }
    catch {
        Write-Warning -Message "$($MyInvocation.MyCommand): $($_.Exception.Message), with: $Uri."
        Write-Warning -Message "$($MyInvocation.MyCommand): For troubleshooting steps see: $($script:resourceStrings.Uri.Info)."
        throw $_
    }

    if ($null -ne $Response) {
        Write-Verbose -Message "$($MyInvocation.MyCommand): Response: $($Response.StatusCode)."
        Write-Verbose -Message "$($MyInvocation.MyCommand): Content type: $($Response.Headers.'Content-Type')."

        # Output content from the response
        switch ($ReturnObject) {
            "All" {
                Write-Verbose -Message "$($MyInvocation.MyCommand): Returning entire response."
                Write-Output -InputObject $Response
                break
            }
            "Headers" {
                Write-Verbose -Message "$($MyInvocation.MyCommand): Returning headers."
                Write-Output -InputObject $Response.Headers
                break
            }
            "RawContent" {
                Write-Verbose -Message "$($MyInvocation.MyCommand): Returning raw content of length: $($Response.RawContent.Length)."
                Write-Output -InputObject $Response.RawContent
                break
            }
            "Content" {
                if ($PSBoundParameters.ContainsKey("Raw")) {
                    $Content = Get-Content -Path $TempFile
                }
                else {
                    $Content = $Response.Content
                }
                Write-Verbose -Message "$($MyInvocation.MyCommand): Returning content of length: $($Content.Length)."
                Write-Output -InputObject $Content
                break
            }
            default {
                if ($PSBoundParameters.ContainsKey("Raw")) {
                    $Content = Get-Content -Path $TempFile
                }
                else {
                    $Content = $Response.Content
                }
                Write-Verbose -Message "$($MyInvocation.MyCommand): Returning content of length: $($Content.Length)."
                Write-Output -InputObject $Content
            }
        }
    }
}