Sample code for 30+ languages & platforms
PowerShell Requires Chilkat v11.0.0+

Process New Email by Scanning for Senders

Scan email and save application-selected emails to EML files with unique filenames.

Chilkat PowerShell Downloads

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

$success = $false

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

$imap = New-Object Chilkat.Imap

#  Connect to an IMAP server.
#  Use TLS
$imap.Ssl = $true
$imap.Port = 993
$success = $imap.Connect("imap.example.com")
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

#  Login
$success = $imap.Login("myLogin","myPassword")
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

#  Select an IMAP mailbox
$success = $imap.SelectMailbox("Inbox")
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

#  We can choose to fetch UIDs or sequence numbers.
$fetchUids = $true

#  Fetch messages from the mailbox using a search criteria.
#  This example finds NEW emails: these are emails that have the RECENT flag set, but not the SEEN flag:
$messageSet = New-Object Chilkat.MessageSet
$success = $imap.QueryMbx("NEW",$fetchUids,$messageSet)
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

#  This example will download headers, and then download
#  the full email for those emails sent from a contact
#  in our database.

#  When downloading headers, each email object contains
#  (obviously) the headers, but the body will be missing.
#  Also, attachments will not be included.  However, it is
#  possible to get information about the attachments
#  as well as the complete size of the email.
$bundle = New-Object Chilkat.EmailBundle
$headersOnly = $true
$success = $imap.FetchMsgSet($headersOnly,$messageSet,$bundle)
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

#  Loop over the email objects...
$emailHeader = New-Object Chilkat.Email
$fullEmail = New-Object Chilkat.Email
$i = 0
$numEmails = $bundle.MessageCount
while ($i -lt $numEmails) {
    $bundle.EmailAt($i,$emailHeader)

    #  The sender's email address and name are available
    #  in the From, FromAddress, and FromName properties.
    #  If the sender is "Chilkat Support <support@chilkatsoft.com",
    #  then the From property will hold the entire string.
    #  the FromName property contains"Chilkat Support",
    #  and the FromAddress property contains "support@chilkatsoft.com";
    $($emailHeader.From)
    $($emailHeader.FromAddress)
    $($emailHeader.FromName)

    #  Assume at this point your code checks to see if the sender
    #  is one in your contacts database.  If so, this is
    #  the code you would write to download the entire
    #  email and save it to a file.

    #  The ckx-imap-uid header field is added when
    #  headers are downloaded.  This makes it possible
    #  to get the UID from the email object.
    $uidStr = $emailHeader.GetHeaderField("ckx-imap-uid")
    $uid = $uidStr

    $success = $imap.FetchEmail($false,$uid,$true,$fullEmail)
    if ($success -eq $false) {
        $($imap.LastErrorText)
        exit
    }

    #  You can use the GenerateFilename method to
    #  generate a unique filename...
    $filename = $fullEmail.GenerateFilename()

    #  SaveEml saves the entire email, including attachments.
    $success = $fullEmail.SaveEml($filename)

    $("--")

    $i = $i + 1
}

#  Disconnect from the IMAP server.
$success = $imap.Disconnect()