(PowerShell) Read IMAP Email Headers

Call FetchHeaders to download only the email headers.

Chilkat .NET Downloads Chilkat .NET Assemblies

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

# This example requires 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.someMailServer.com")
if ($success -ne $true) {
    $($imap.LastErrorText)
    exit
}

# Login
$success = $imap.Login("****","****")
if ($success -ne $true) {
    $($imap.LastErrorText)
    exit
}

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

# We can choose to fetch UIDs or sequence numbers.
$fetchUids = $true
# Get the message IDs of all the emails in the mailbox
$messageSet = $imap.Search("ALL",$fetchUids)
if ($imap.LastMethodSuccess -ne $true) {
    $($imap.LastErrorText)
    exit
}

# 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 = $imap.FetchHeaders($messageSet)
if ($imap.LastMethodSuccess -ne $true) {

    $($imap.LastErrorText)
    exit
}

# Loop over the email objects and display information
# about each:

for ($i = 0; $i -le $bundle.MessageCount - 1; $i++) {

    $email = $bundle.GetEmail($i)

    # Display the From and Subject
    $($email.From)
    $($email.Subject)

    # Display the recipients:

    for ($j = 0; $j -le $email.NumTo - 1; $j++) {
        $name = $email.GetToName($j)
        $addr = $email.GetToAddr($j)
        $($name + ", " + $addr)
    }

    for ($j = 0; $j -le $email.NumCC - 1; $j++) {
        $name = $email.GetCcName($j)
        $addr = $email.GetCcAddr($j)
        $($name + ", " + $addr)
    }

    # Show the total size of the email, including body and attachments:
    $($email.Size)

    # When a full email is downloaded, we would use the
    # email.NumAttachments property in conjunction with the
    # email.GetMailAttach* methods.
    # However, when an email object contains only the header,
    # we need to access the attachment info differently:
    $numAttach = $imap.GetMailNumAttach($email)
    for ($j = 0; $j -le $numAttach - 1; $j++) {
        $($imap.GetMailAttachFilename($email,$j))
        $attachSize = $imap.GetMailAttachSize($email,$j)
        $("    size = " + $attachSize + " bytes")
    }

    $("--")

}

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