Copies a file to an FTP(S) server

Copy-ToFtp.ps1

# Copyright: (c) 2022, Jordan Borean (@jborean93) <[email protected]>
# MIT License (see LICENSE or https://opensource.org/licenses/MIT)

Function Copy-ToFtp {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory = $true)]
        [System.String]
        $Path,

        [Parameter(Mandatory = $true)]
        [System.Uri]
        [Alias('Uri')]
        $FtpUrl,

        [PSCredential]
        $Credential
    )

    $secure = $false
    if ($FtpUrl.Scheme -eq 'ftps') {
        $secure = $true
        $FtpUrl = [uri]('ftp' + ($FtpUrl.ToString().Substring(4)))
    }

    $request = [System.Net.WebRequest]::Create($FtpUrl)
    if (-not $request -is [System.Net.FtpWebRequest]) {
        Write-Error -Message "FtpUrl is not a valid FTP address starting with ftp://"
        return
    }

    $request.Method = [System.Net.WebRequestMethods+Ftp]::UploadFile

    if ($secure) {
        $request.EnableSSL = $true
    }

    if ($Credential) {
        $request.Credentials = $Credential
    }

    $ftpWriter = $null
    try {
        $ftpWriter = $request.GetRequestStream()

        $outFS = [System.IO.File]::OpenRead($Path)
        try {
            $outFS.CopyTo($ftpWriter)
        }
        finally {
            $outFS.Dispose()
        }

    }
    catch {
        Write-Error -Message "Failed to upload file to FTP: $($_.Exception.Message)" -Exception $_.Exception
        return

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