(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.

Chilkat .NET Downloads Chilkat .NET Assemblies

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

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

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

# Login
$success = $imap.Login("myLogin","myPassword")
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 -eq $false) {
    $($imap.LastErrorText)
    exit
}

# Fetch the emails into a bundle object:

$bundle = $imap.FetchBundle($messageSet)
if ($imap.LastMethodSuccess -eq $false) {

    $($imap.LastErrorText)
    exit
}

# Loop over the bundle and display the FROM and SUBJECT of each.
$i = 0
$numEmails = $bundle.MessageCount
while ($i -lt $numEmails) {
    $email = $bundle.GetEmail($i)
    $($email.From)
    $($email.Subject)
    $("--")

    $i = $i + 1
}

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