Public/Web/Save-WebFile.ps1

<#
.SYNOPSIS
Downloads a file from the internet and returns a Get-Item Object
 
.DESCRIPTION
Downloads a file from the internet and returns a Get-Item Object
 
.LINK
https://osd.osdeploy.com/module/functions/save-webfile
 
.NOTES
21.3.16.2 Updated to Return Get-Item
#>

function Save-WebFile {
    [CmdletBinding()]
    param (
        #URL of the file to download
        [Parameter(Position = 0, Mandatory = $true, ValueFromPipeline)]
        [string]$SourceUrl,

        #Destination File Name
        [string]$DestinationName,

        #Destination Folder
        [Alias('Path')]
        [string]$DestinationDirectory = "$env:TEMP\OSD",

        #Overwrite the file if it exists already
        #The default action is to skip the download
        [switch]$Overwrite
    )
    #=======================================================================
    # DestinationDirectory
    #=======================================================================
    if (Test-Path "$DestinationDirectory") {
    }
    else {
        New-Item -Path "$DestinationDirectory" -ItemType Directory -Force -ErrorAction Stop | Out-Null
    }
    Write-Verbose "DestinationDirectory: $DestinationDirectory"
    #=======================================================================
    # DestinationName
    #=======================================================================
    if ($PSBoundParameters['DestinationName']) {
    }
    else {
        $DestinationName = Split-Path -Path $SourceUrl -Leaf
    }
    Write-Verbose "DestinationName: $DestinationName"
    #=======================================================================
    # WebFileFullName
    #=======================================================================
    $DestinationDirectoryItem = (Get-Item $DestinationDirectory).FullName
    $DestinationFullName = Join-Path $DestinationDirectoryItem $DestinationName
    #=======================================================================
    # OverWrite
    #=======================================================================
    if ($PSBoundParameters['Overwrite']) {
    }
    else {
        if (Test-Path $DestinationFullName) {
            Write-Verbose "DestinationFullName already exists"
            Return Get-Item $DestinationFullName
        }
    }
    #=======================================================================
    # Download
    #=======================================================================
    if (Get-Command 'curl.exe') {
        Write-Verbose "cURL: $SourceUrl"

        if ($host.name -match 'ConsoleHost') {
            Invoke-Expression "& curl.exe --location --output `"$DestinationFullName`" --url $SourceUrl"
        }
        else {
            #PowerShell ISE will display a NativeCommandError, so progress will not be displayed
            $Quiet = Invoke-Expression "& curl.exe --location --output `"$DestinationFullName`" --url $SourceUrl 2>&1"
        }
    }
    else {
        [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls1
        $WebClient = New-Object System.Net.WebClient
        $WebClient.DownloadFile($SourceUrl, $DestinationFullName)
    }
    #=======================================================================
    # Return
    #=======================================================================
    if (Test-Path $DestinationFullName) {
        Return Get-Item $DestinationFullName
    }
    else {
        Write-Warning "Could not download $DestinationFullName"
        Return $null
    }
    #=======================================================================
}