Downloads a file from a url and outputs the path to the file

Download-File.ps1

#
# Downloads the given URL to a local file and outputs the path to the file
#
function Download
{
    param([Parameter(Mandatory=$true)][string] $Url)

    $webClient = $null

    try 
    {
        $uri = [URI] $url

        $update = $uri.Segments[$uri.Segments.Count - 1]
        
        $localFile = '{0}\{1}' -f $DSC_MainWorkingFolder, $update

        if (Test-Path $localFile) {
            throw New-HandlerTerminatingError `
                -Code $DSC_Status.WmfInstallError.Code `
                -Message ($DSC_Status.WmfInstallError.Message -f $update, (GetLogDirectory))
        }

        Write-Log "Downloading $Url ..."
    
        $webClient = New-Object System.Net.WebClient

        $webClient.DownloadFile($Url, $localFile)

        $localFile

    }
    finally
    {
        if ($webClient) {
            $webClient.Dispose()
        }
    }
}