Sample code for 30+ languages & platforms
PowerShell Requires Chilkat v9.5.0.76+

SFTP Sync Download Tree w/ Must-Match Filename Constraints

See more SFTP Examples

Demonstrates how synchronize a directory tree in the download direction, but only download files matching a set of wildcard filenames.

Chilkat PowerShell Downloads

PowerShell
Add-Type -Path "C:\chilkat\ChilkatDotNet47-x64\ChilkatDotNet47.dll"

$success = $false

#  This example requires the Chilkat API to have been previously unlocked.
#  See Global Unlock Sample for sample code.

$sftp = New-Object Chilkat.SFtp

$success = $sftp.Connect("my-ssh-server.com",22)
if ($success -eq $true) {
    $success = $sftp.AuthenticatePw("mySshLogin","mySshPassword")
}

if ($success -eq $true) {
    $success = $sftp.InitializeSftp()
}

if ($success -ne $true) {
    $($sftp.LastErrorText)
    exit
}

#  Possible synchronization modes are:
#  mode=0: Download all files
#  mode=1: Download all files that do not exist on the local filesystem.
#  mode=2: Download newer or non-existant files.
#  mode=3: Download only newer files. If a file does not already exist on the local filesystem, it is not downloaded from the server.
#  mode=5: Download only missing files or files with size differences.
#  mode=6: Same as mode 5, but also download newer files.

#  This example will download all files, but only those files having filenames
#  that match *.gif and *.eml

#  Imagine our remote directory tree has these files and directories:

#  	accentedLatin1.txt
#  	accentedUtf8.txt
#  	alice.key
#  	anter_cert.pem
#  	chiliPepper.gif
#  	helloWorld.pdf
#  	abc/chiliPepper.gif
#  	abc/ghk/
#  	data/chiliPepper.gif
#  	data/xyz/dkimHtmlBody.txt
#  	data/xyz/dkimVerifyTest.eml
#  	data/xyz/emailForCreateDsn.eml
#  	text/frenchUtf8.txt
#  	text/helloWorld.txt
#  	text/PolishEmailBody.txt
#  	text/something/

#  Indicate that we only want to create auto-create local directories (if needed)
#  for the files that are actually downloaded.  If SyncCreateAllLocalDirs remains
#  $true, then the corresponding local directory is created for each remote directory
#  traversed regardless of whether files within are downloaded.
$sftp.SyncCreateAllLocalDirs = $false

$sftp.SyncMustMatch = "*.eml; *.gif"

$remoteDir = "syncDownloadTest/someDir"
$localDir = "qa_output"
$mode = 0
$recursive = $true
$success = $sftp.SyncTreeDownload($remoteDir,$localDir,$mode,$recursive)
if ($success -ne $true) {
    $($sftp.LastErrorText)
    exit
}

#  The following files were downloaded:

#  chiliPepper.gif
#  abc/chiliPepper.gif
#  data/chiliPepper.gif
#  data/xyz/dkimVerifyTest.eml
#  data/xyz/emailForCreateDsn.eml

$("Success.")