PowerShell

IMAP STARTTLS (Explicit TLS/SSL)

The StartTls property is set to force the Connect method to automatically convert an connection to TLS/SSL via the STARTTLS IMAP command.

This is also known as "explicit TLS/SSL" as opposed to "implicit TLS/SSL". With implicit TLS/SSL, the IMAP client connects on the well-known IMAP TLS/SSL port 993 and the secure channel is immediately established. With explicit TLS/SSL, the IMAP client connects on the typical non-secure port (143 usually) and the converts the connection via the STARTTLS command.

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

# Indicate that STARTTLS should be used to convert
# to a secure TLS/SSL connection:
$imap.StartTls = $true
$imap.Port = 143

# Connect to an IMAP server and convert the connection
# to TLS/SSL via STARTTLS.
$success = $imap.Connect("imap.example.com")
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

# The remainder of this example is the same as for 
# non-TLS/SSL...

# 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
}

# Get the message IDs of all the emails in the mailbox
$fetchUids = $true
$messageSet = New-Object Chilkat.MessageSet
$success = $imap.QueryMbx("ALL",$fetchUids,$messageSet)
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

# Fetch the emails into a bundle object:
$bundle = New-Object Chilkat.EmailBundle
$headersOnly = $false
$success = $imap.FetchMsgSet($headersOnly,$messageSet,$bundle)
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

# Loop over the bundle and display the FROM and SUBJECT of each.
$email = New-Object Chilkat.Email
$i = 0
$numEmails = $bundle.MessageCount
while ($i -lt $numEmails) {
    $bundle.EmailAt($i,$email)

    $($email.From)
    $($email.Subject)
    $("--")
    $i = $i + 1
}

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