Tools for Moving to a Microsoft Collaboration Platform

I'm back..............

2010-03-22T04:08:00Z

I'm happy to have returned to Microsoft.

My new blog is http://blogs.technet.com/loum/

Good Bye and Good Luck

2009-05-08T22:28:00Z

I've spent the past six years here at Microsoft, 1/2 of which was dedicated to helping move customers to our platform from Lotus.

I wish the remaining team good luck.

Sincerely,

Lou Mandich.

Free Scripts from the Migration Community

2008-11-20T18:52:00Z

I would like to thank Mark Smith for contributing this IP and allwing me to blog this on his behalf for the benefit of the community.

Here is Mark's introduction...

"Mark is the Infrastructure Practice Manager and Principal Architect for Capax Global Consulting. He has been involved with Email/messaging systems since 1992 and with Microsoft Exchange since 5.0. Mark’s current work is with Microsoft Infrastructure products with a focus on upgrades/migrations to Microsoft Exchange Server. Mark has a BS (Computer Science) and BA (Mass Communications) from Widener University."

Please download the attachment below.

Updated script for Moving Domino Groups containing SMTP Addresses

2008-09-05T16:45:00Z

Thank you Casey Spiller for updating this script!

##################################################################################################
# Move-DominoGroupWithSMTP.ps1
#
# Written by Casey Spiller
#
#
# This script will move Domino Groups to Active Directory while preserving SMTP Addresses by
# creating contacts in AD for these users. By default Move-DominoGroupToAD will drop SMTP
# addresses if they do not already exist in AD.
#
# For troubleshooting, please locate the transcript of the script which should be located
# in your My Documents folder (by default).
#
# Known issues: If a user has an SMTP Address on a Domino Group that is also the SMTP Address used
# of a MailUser, we will drop this address. Search the transcript for "SKIPPING" to locate any
# MailUsers who were dropped.
#
#
# Disclaimer:
# This script is not supported under any Microsoft standard support program or service. This
# sample script are provided AS IS without warranty of any kind. Microsoft further disclaims
# all implied warranties including, without limitation, any implied warranties of merchantability
# or of fitness for a particular purpose. The entire risk arising out of the use or performance
# of the sample scripts and documentation remains with you. In no event shall Microsoft, its
# authors, or anyone else involved in the creation, production, or delivery of the scripts be
# liable for any damages whatsoever (including, without limitation, damages for loss of business
# profits, business interruption, loss of business information, or other pecuniary loss) arising
# out of the use of or inability to use this script or documentation, even if Microsoft
# has been advised of the possibility of such damages.
#
##################################################################################################

# Input Parameters
param ([string]$DominoGroup = "", [string]$GlobalCatalogServer = "", [string]$ADContainer = "", [switch]$help=$false, [switch]$All = $false,[switch]$CreateContactsOnly=$false);

#regex to identify SMTP addresses
$smtpregex = "^([a-zA-Z0-9_\-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([a-zA-Z0-9\-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$";
$iAddress = 0;

Function ShowHelp
{

Write-Host "Written by Casey Spiller" -foregroundcolor "White";
Write-Host "This Script will Move Domino Groups to Active Directory while preserving SMTP";
Write-Host "Addresses by creating Contacts in AD for these users.";
Write-Host "";

Write-Host "Options:" -foregroundcolor "White";
Write-Host "-DominoGroup          : Used to specify the Domino Group we wish to migrate for";
Write-Host "                        migrating groups one at a time";
Write-Host "";
Write-Host "-All                  : Used to migrate all Domino Groups at once. This option";
Write-Host "                        overrides the -DominoGroup option";
Write-Host "";
Write-Host "-GlobalCatalogServer : Used to specify the GC/DC";
Write-Host "";
Write-Host "-ADContainer          : Used to specify the Container in AD to write contacts to";
Write-Host "";
Write-Host "-CreateContactsOnly   : Used to Create Contacts in AD and NOT Move Groups";
Write-Host "";
Write-Host "Usage: " -foregroundcolor "White";
Write-Host "Move-DominoGroupwithSMTP.ps1 -DominoGroup ContosoAll -GlobalCatalogServer dc.contoso.com -ADContainer Users" -foregroundcolor "Green";
Write-Host "";

}

Function VerifyParams
{
if (!$DominoGroup -and $All -eq $false)
{
ShowHelp;
Write-Host "Missing 'DominoGroup' or 'All' Parameter. Either 'DominoGroup' or 'All' is required" -foregroundcolor "Red";
Write-Host "";
stop-transcript;
exit;
}

if (!$GlobalCatalogServer)
{
ShowHelp;
Write-Host "Missing 'GlobalCatalogServer' Parameter" -foregroundcolor "Red";
Write-Host "";
stop-transcript;
exit
}

if (!$ADContainer)
{
ShowHelp;
Write-Host "Missing 'ADContainer' Parameter" -foregroundcolor "Red";
Write-Host "";
stop-transcript;
exit
}

}
Function CheckForAddress
{
#initialize integer

#Write-Host $member.ToString();
if (Get-MailContact $member.ToString() -ErrorAction SilentlyContinue)
{
$iAddress++;
Write-Host "Contact detected for" $member "SKIPPING" -foregroundcolor "Blue" ;
}

#Detect if we've found a Contact with the Address already for performance

if ($iAddress -eq 0)
{

if (Get-MailBox $member.ToString() -ErrorAction SilentlyContinue)
   {
    $iAddress++;
    Write-Host "Mailbox detected for" $member "SKIPPING" -foregroundcolor "Blue";
   }

}
#Detect if we've found a Contact with the Address already for performance

if ($iAddress -eq 0)
{

if (Get-MailUser $member.ToString() -ErrorAction SilentlyContinue)
   {
    $iAddress++;
    Write-Host "MailUser detected:" $member "SKIPPING" -foregroundcolor "Blue";
    Write-Host "Move-DominoGroupToAD will not move this user as it is a MailUser" -foregroundcolor "Blue";
   }

}
return $iAddress;
}

#
#Begin actual script
#

start-transcript -Verbose;
# Display help if -help is specified
if ($help -eq $true)
{ShowHelp; exit }
else { }

#Check for params
VerifyParams;

Write-Host "";
Write-Host "Using the folling regex to detect what a valid SMTP Address is: " $smtpregex
Write-Host "-----------------------";

#Set DominoGroup to null if we are doing all DominoGroups
if ($All)
{$DominoGroup = $null}

foreach ($group in (Get-DominoGroup $DominoGroup))
{
Write-Host "Domino Group: " $group.Name;

foreach ($member in ($group.Members))
{

# we need to parse through the members to look for smtp addresses.
# ie user@domain.com. We need both the @ and the "."

if ($member -match $smtpregex)
   {


    # Call CheckForAddress to verify if the address already exists in AD, set iAddress if we find the Address in AD
    $iAddress = CheckForAddress;

     if ($iAddress -eq 0)
      {

      #create a new alias, we will change "@" to "_"
      $alias = $member.ToString().Replace("@","_");
      Write-Host "-----------------------";
      Write-Host "Domino Group contains member identified with an SMTP Address:" $member
      Write-Host "New-MailContact -Name" $member "-ExternalEmailAddress" $member "-OrganizationalUnit" $ADContainer "-DomainController" $GlobalCatalogServer -foregroundcolor "Green";
      New-MailContact -Name $alias -ExternalEmailAddress $member.ToString() -OrganizationalUnit $ADContainer -DomainController $GlobalCatalogServer
      Write-Host "-----------------------";

}
}

}
Write-Host "----------------------------------------------";

}

Write-Host "----------------------------------------------";
Write-Host "";
Write-Host "";

if (!$CreateContactsOnly -eq $true)
{
Write-Host "Now calling Move-DominoGroupToAD ";
Write-Host "MoveDominoGroupToAD" $DominoGroup "-TargetOU" $ADContainer "-GlobalCatalog" $GlobalCatalogServer -foregroundcolor "Green";
Move-DominoGroupToAD $DominoGroup -TargetOU $ADContainer -GlobalCatalog $GlobalCatalogServer -verbose;
}
else {
Write-Host "Contact Only mode, No DominoGroups will be created in ActiveDirectory";

foreach ($group in (Get-DominoGroup $DominoGroup))
{
Write-Host "Domino Group: " $group.Name;

foreach ($member in ($group.Members))
{

# we need to parse through the members to look for smtp addresses.
# ie user@domain.com. We need both the @ and the "."

      }
   }
   }
   }


}

Write-Host "";
stop-transcript;
############
# End Script #
############

What's new for Transporter Suite in regards to Lotus Domino in the July 2008 Release.

2008-07-08T19:06:00Z

What's new for Transporter Suite in regards to Lotus Domino in the July 2008 Release.

Download the Suite from here -> http://www.microsoft.com/downloads/details.aspx?FamilyId=35FC4205-792B-4306-8E4B-0DE9CCE72172&displaylang=en

Customers have been asking what's new or updated ? Below is the list based on customer feedback and our continued improvement in our products.

Domino User Migration (Move-DominoUser Cmdlet)

Address matching

· Improved support for interoperability with ILM

Alias handling

· Additional periods in alias are replaced with underscore after migration

Multi-domain replication issue

· User migration fails with duplicate proxy address caused by RUS and move-dominouser DC concurrency.

Custom attributes

· Custom Attributes now preserved from DirSync contacts

Domino Mail Migration (Move- DominoMailbox Cmdlet)

BCC recipients

· Bcc: recipients now preserved

Attachment handling & text alignment

· Improved Attachment handling

· Improved handling of Hebrew text

Recurring Meetings & Appointments

· Better logic for maintaining parent-child relationship of recurring meetings

· Addressed issues with preserving Meeting Organizer role

· Relationship between meeting organizer and meeting attendee now preserved

· Improved handling for yearly recurring appointments and all day events

Domino Group Migration (Move-DominoGroup)

Better extraction support

· Better default handling for non-default names.nsf templates

Move-DominoGroupToAD: How to migrate SMTP addresses with groups

2008-04-04T19:40:00Z

When attempting to migrate groups from Lotus Notes to Exchange 2007 with the Transporter for Lotus Notes, you may notice that Groups that contain SMTP addresses (non Exchange or Notes users) are not migrated with the group. I became aware of this issue recently when working with a customer and wrote a script to assist in getting these SMTP addresses migrated over cleanly.

So in the first screenshot we see a group in Domino that we want to migrate. By default the addresses highlighted below will not be migrated to AD.

Above: The circled users will not be migrated to AD unless the contacts are created beforehand.

Enter Move-DominoGroupToADWithSMTP.ps1:

So the solution is to create a powershell script to come along beforehand and create the contacts. What we risk here is that the contacts will not be created and replicated in the time it takes to run the script, so we tell the script a Global Catalog Server to point to. In the first stage we use this server to write the contact to. In the second stage we call MoveDominoGroupToAD which expects the contact to be there.

In cases where we cannot do this or encounter problems with Move-DominoGroupToAD not detecting contacts in Active Directory, we can use the –CreateContactsOnly switch to create the contacts. Once these contacts replicate throughout Active Directory, we can continue on with the next step of running Move-DominoGroupToADWithSMTP.ps1 or just call Move-DominoGroupToAD directly.

The Script:

# Input Parameters
param ([string]$DominoGroup = "", [string]$GlobalCatalogServer = "", [string]$ADContainer = "", [switch]$help=$false, [switch]$All = $false,[switch]$CreateContactsOnly=$false);

#regex to identify SMTP addresses
$smtpregex = "^([a-zA-Z0-9_\-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([a-zA-Z0-9\-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$";
$iAddress = 0;

Function ShowHelp
{

}

Function VerifyParams
{
if (!$DominoGroup -and $All -eq $false)
  {
  ShowHelp;
  Write-Host "Missing 'DominoGroup' or 'All' Parameter. Either 'DominoGroup' or 'All' is required" -foregroundcolor "Red";
  Write-Host "";
  stop-transcript;
  exit;
  }

if (!$GlobalCatalogServer)
  {
  ShowHelp;
  Write-Host "Missing 'GlobalCatalogServer' Parameter" -foregroundcolor "Red";
  Write-Host "";
  stop-transcript;
  exit
  }

if (!$ADContainer)
  {
  ShowHelp;
  Write-Host "Missing 'ADContainer' Parameter" -foregroundcolor "Red";
  Write-Host "";
  stop-transcript;
  exit
  }

}
Function CheckForAddress
{
#initialize integer

#Write-Host $member.ToString();
if (Get-MailContact $member.ToString() -ErrorAction SilentlyContinue)
  {
   $iAddress++;
   Write-Host "Contact detected for" $member "SKIPPING" -foregroundcolor "Blue" ;
  }

#Detect if we've found a Contact with the Address already for performance

if ($iAddress -eq 0)
{

  if (Get-MailBox $member.ToString() -ErrorAction SilentlyContinue)
   {
    $iAddress++;
    Write-Host "Mailbox detected for" $member "SKIPPING" -foregroundcolor "Blue";
   }

}
#Detect if we've found a Contact with the Address already for performance

if ($iAddress -eq 0)
{

}
return $iAddress;
}

#
#Begin actual script
#

start-transcript -Verbose;
# Display help if -help is specified
if ($help -eq $true)
{ShowHelp; exit }
else { }

#Check for params
VerifyParams;

Write-Host "";
Write-Host "Using the folling regex to detect what a valid SMTP Address is: " $smtpregex
Write-Host "-----------------------";

#Set DominoGroup to null if we are doing all DominoGroups
if ($All)
{$DominoGroup = $null}

foreach ($group in (Get-DominoGroup $DominoGroup))
{
Write-Host "Domino Group: " $group.Name;

foreach ($member in ($group.Members))
{

# we need to parse through the members to look for smtp addresses.
# ie user@domain.com. We need both the @ and the "."

      }
   }


}
Write-Host "----------------------------------------------";

}

Write-Host "----------------------------------------------";
Write-Host "";
Write-Host "";

Casey Spiller

merge-dominoUser.ps1 a powershell script for move-dominoUser cmdlet

2008-02-11T21:10:00Z

# merge-DominoUser.ps1

# ------------- DISCLAIMER -----------------------

# The code herein is provided as is with no gurantee or waranty concerning

# the usability or impact on your messaging system and may be used, distributed

# or modified for use provided the parties agree and acknowledge the Microsoft or

# Microsoft Partners have neither accountabilty or responsibility for results

# produced by use of this script.

# Developed by Jeff Kizner, Brad Hughes and Ed Thornburg

# -------------------------------------------------

# The script below provides the same functionality as move-dominoUser but does not enable

# the email address policy generator [RUS]. The default behavior of move-dominoUser is to

# mailbox enable the user object, apply email address policy as primary addresses and

# then add email addresses from contacts as secondary email addresses. If you intend to

# persist contact email addresses as primary email addresses of the mailbox enabled user,

# then this script is for you.

# The script takes a csv with header of samAccountName,InternetAddress and

# mailbox enables the user object matching the samAccountName and merging

# the contact with the matching primary smtp address.

# In this case the DisplayName is persisted as well.

# The minimum csv header: samAccountName,InternetAddress,displayName

# The script has four major sections, each of which can be run independently

# in sequence; a variable delay timer separates the major sections and is

# implementedto accomodate for directory replication latency

# process flow:

# add the heading for Domino directory values to be persisted to Active Directory

# note that the combinedObjectData merges the attribute data from the csv and

# the contact for the associated user into the same object and that object

# is finally exported to csv to provide the data for the enable-mailbox cmdlet

# the last part adds specific data to the mailbox enabled user

# -verbose provides realtime viewing of operations

start-transcript .\move-dominoUserScript.txt

# $netbiosDomainName = is a static definition of the netbios domain name of your active directory forest

# this value combined with the samaccountname;

# cmdlets accept domain\samaccountname for -identity switch

$netbiosDomainName = "Your_netBIOS_domain"

# ParseEmailAddresses function is necessary as contact.emailAddresses returns an array object;

# not the content of the array.

function ParseEmailAddresses([object[]] $addresses)

{

$sbAddress = New-Object System.Text.StringBuilder;

$tmp = $sbAddress.Append($addresses[0])

for($x = 1; $x -lt $addresses.Length; $x++)

{

$tmp = $sbAddress.AppendFormat(",{0}",$addresses[$x]);

}

$sbAddress.ToString();

}

# end function

# the code below merges the data for each entry in the csv

# with data from the contact that corresponds to that entry in the csv

# the combined data is in turn written to a csv containing all data

# necessary to persist the data for the mailbox enabled user

$dominoExportData = Import-Csv .\migrationList.csv

$combinedObjectData = $dominoExportData | foreach {

$contactInfo = Get-MailContact -Identity $_.InternetAddress | Select-Object PrimarySmtpAddress,LegacyExchangeDN,EmailAddresses;

Add-Member -InputObject $_ -MemberType NoteProperty -Name PrimarySmtpAddress -Value $contactinfo.PrimarySmtpAddress;

Add-Member -InputObject $_ -MemberType NoteProperty -Name LegacyExchangeDN -Value $contactinfo.LegacyExchangeDN;

$strAddress = ParseEmailAddresses($contactinfo.EmailAddresses);

Add-Member -InputObject $_ -MemberType NoteProperty -Name EmailAddresses -Value $strAddress;

$_;

}

$combinedObjectData | Export-Csv -NoType .\mkmbx.csv

# variable delay timer to accomodate directory replication latency

sleep -seconds 60

import-csv MigrationList.csv | foreach {

get-mailcontact -identity $_.internetaddress | remove-mailcontact -confirm:$FALSE

}

# variable delay timer to accomodate directory replication latency

sleep -seconds 60

import-csv mkmbx.csv | foreach {

$targetdatabase = ((get-mailbox -resultsize unlimited | group-object -Property database | select-object name,count | sort-object -Property count)[0].name)

Enable-Mailbox -Identity "$netbiosDomainName\$($_.samAccountName)" -database $targetdatabase -ManagedFolderMailboxPolicyAllowed:$TRUE -ActiveSyncMailboxPolicy "Default" -ManagedFolderMailboxPolicy "Empty Deleted Items" -confirm:$FALSE

}

# variable delay timer to accomodate directory replication latency

sleep -seconds 120

# code adds to the previously enabled mailbox

import-csv mkmbx.csv | foreach {

$mailaddr = $_.emailaddresses

$mailaddr = $mailaddr.Split(",")

# add the legacyExchangeDN of the contact as X500 of user to allow

# for reply to mail sent when user was in foreign system

$mailaddr += "x500:$($_.LegacyExchangeDN)"

set-mailbox -Identity "$netbiosDomainName\$($_.samAccountName)" -EmailAddressPolicyEnabled $false -PrimarySmtpAddress $_.primarySMTPAddress -verbose

set-mailbox -Identity "$netbiosDomainName\$($_.samAccountName)" -EmailAddresses $mailaddr -verbose

set-casmailbox -Identity "$netbiosDomainName\$($_.samAccountName)" -ActiveSyncEnabled $FALSE -IMAPEnabled $FALSE -POPEnabled $FALSE -verbose

# persist displayName from csv input file

Set-User -Identity $_.samAccountName -DisplayName $_.displayName.Trim() -verbose

}

stop-transcript

A major update to the Microsoft Transporter Suite was released on Monday, January 21st, 2008.

2008-01-25T12:40:00Z

Earlier this week we released a major update to the Microsoft Transporter Suite (A set of tools that help customers migrate content into Exchange, SharePoint and Active Directory). The Microsoft Transporter Suite is now available for download (here)

What’s New?

This release focused on adding the ability to migrate mailboxes from Generic POP/IMAP servers and improving the overall quality of the previously released Domino migration tools.

New Features/Fixes in this release

o NEW: Transporter Suite for Internet Mailboxes (A whole new console and tools for migrating POP/IMAP Mailboxes)

§ Migration of mailbox content from generic servers through POP or IMAP to Exchange 2007

§ Preserves all messages and folder structures

§ Preserves rich content including formatting, message flags and even calendaring through iCAL

§ Exposed through GUI and a rich set of PowerShell tasks

o Updated: Domino migration tools

§ Improved support in the Console for large organizations

§ Enhanced troubleshooting through tracing, improved logging, and capturing of items that do not migrate

§ Improved application migration by preserving created/modified identities

§ Enhanced security of the Free/Busy connector

Screen Shots Of Internet Mailbox Migrations

Initial Screen

List of Mailboxes

(Notice the migration status feature to track mailboxes that have been migrated)

Mailbox Migration Wizard

Domino to Exchange Messaging Migration Tools Solutions Matrix

2007-11-08T23:43:00Z

This is a living document to describe the features between multiple different messaging migration tools used for Domino to Exchange.

It is only meant to be an aid, not a definitive solution. It will help you narrow your choices when comparing toolsets.

Please send me a list of features you would like added, or other products. I'm not perfect, I make mistakes too, so if you need me to fix the

sheet, please let me know.

Transporter Suite End-to-End Guidance Released

2007-10-27T01:36:00Z

Have you been waiting with bated breath for fantastic end to end guidance around the Microsoft Transporter Suite for Lotus Domino? Well my good reader, your wait is over! We’ve been working hard with support and with the field to make sure that the information in here is solid. This is a release where even support is excited about the quality. It covers planning and executing on your directory and mail transition, including groups, archives, and PABs! It can be downloaded here.

We already know that there are some topics that we didn’t get a chance to cover, so stay tuned for future updates on this doc. If there are particular topics you are interested in, please feel free to leave them in the comments. In the meantime, go forth and be guided!

Microsoft Transporter Suite End to End Guidance