(PowerShell) Read IMAP Email Headers

Call FetchHeaders to download only the email headers.

Note: This example requires Chilkat v11.0.0 or greater.

Chilkat .NET Downloads Chilkat .NET Assemblies

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.

$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("****","****")
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

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

# Get the message IDs of all the emails in the mailbox
# We can choose to fetch UIDs or sequence numbers.
$fetchUids = $true
$messageSet = New-Object Chilkat.MessageSet
$success = $imap.QueryMbx("ALL",$fetchUids,$messageSet)
if ($success -eq $false) {
    $($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 = New-Object Chilkat.EmailBundle
$headersOnly = $true
$success = $imap.FetchMsgSet($headersOnly,$messageSet,$bundle)
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

# Loop over the email objects and display information
# about each:
$email = New-Object Chilkat.Email

$i = 0
$j = 0
while ($i -lt $bundle.MessageCount) {
    $bundle.EmailAt($i,$email)

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

    # Display the recipients:
    $j = 0
    while ($j -lt $email.NumTo) {
        $("TO: " + $email.GetToName($j) + ", " + $email.GetToAddr($j))
        $j = $j + 1
    }

    $j = 0
    while ($j -lt $email.NumCC) {
        $("CC: " + $email.GetCcName($j) + ", " + $email.GetCcAddr($j))
        $j = $j + 1
    }

    # 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)
    $j = 0
    while ($j -lt $numAttach) {
        $($imap.GetMailAttachFilename($email,$j))
        $attachSize = $imap.GetMailAttachSize($email,$j)
        $("    size = " + $attachSize + " bytes")
        $j = $j + 1
    }

    $("--")
}

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