• Outlook User
  • New Outlook app
  • Outlook.com
  • Outlook Mac
  • Outlook & iCloud
  • Developer
  • Microsoft 365 Admin
    • Common Problems
    • Microsoft 365
    • Outlook BCM
    • Utilities & Addins

Use PowerShell to Bulk Change Contacts

Slipstick Systems

› Developer › Use PowerShell to Bulk Change Contacts

Last reviewed on October 14, 2022     2 Comments

Applies to: Outlook (classic), Outlook 365 (Win)

I have a series of macros that can bulk change contacts, but using a macro is not the only way to bulk change contacts. You can make the same changes using a PowerShell script.

Any Outlook field can be manipulated using PowerShell. This script sample changes the File As and Email Display Name field of the Contacts in the Default Contacts folder to match the Full Name field.

To use, right-click on the Start menu in Windows 10 and click on the Windows PowerShell entry. Paste the entire script in the PowerShell window and press Enter.
bulk change contact fields

Note: This PowerShell script will not work with the Windows Store version of Office. You'll need to use the macro version if you have the Windows store version of Office installed.

Like the Bulk Change Email Display Name Format macro, the PowerShell version uses the default FileAs format or a custom format. Use the same method to change other Outlook fields.

Change the Email Display Name field

This PowerShell changes the email display name field for Email1. You can tweak it to change the display names for Email2 and Email3 as well. You can use the macro on the default folder or comment out (add a # to the beginning of the line) the default folder line, remove the comment block (#) from the selected folder line and run it on the selected folder.

bulk change the display name field

$olApp = new-object -comobject outlook.application
$namespace = $olApp.GetNamespace("MAPI")

# Default Contacts folder
$Contacts = $namespace.GetDefaultFolder(10)

# Uses current folder
#$Contacts = ($olApp.ActiveExplorer()).CurrentFolder

foreach ($Contact in $Contacts.Items)
{

# Change only contacts with SMTP address
    if ($Contact.Email1Address -like "*@*")
    {
  
# Uncomment the file as format you want
        #Lastname, Firstname (Company) format               
        # $newFileAs  = $Contact.FullNameAndCompany 
                
        #Firstname Lastname format
        # $newFileAs  = $Contact.FullName
               
        #Lastname, Firstname format
        # $newFileAs  = $Contact.LastNameAndFirstName
               
        #Company name only
        # $newFileAs  = $Contact.CompanyName
               
        #Companyname (Lastname, Firstname)
        # $newFileAs  = $Contact.CompanyAndFullName

        # Custom format 
       $newFileAs  =  $Contact.CompanyName + " (" + $Contact.FullName + ")"
      
# Comment out lines if you don't want to change the field
 
   # $Contact.FileAs  = $Contact.CompanyAndFullName
   $Contact.Email1DisplayName = $newFileAs
   
   $Contact.Save()

    }
}

$olApp.Quit | Out-Null
[GC]::Collect()

 

Swap First and Last Name fields

To swap fields, you need to add the current field value to a variable then add them to the other field. Don't forget to Save the contact!
swap first and last name fields

The macro version of this script is at Macro to Swap First and Last Name Fields

$olApp = new-object -comobject outlook.application
$namespace = $olApp.GetNamespace("MAPI")

# Default Contacts folder
$Contacts = $namespace.GetDefaultFolder(10)

# Uses current folder
#$Contacts = ($olApp.ActiveExplorer()).CurrentFolder

foreach ($Contact in $Contacts.Items)
{

   $curFirstName  = $Contact.FirstName
   $CurLastName = $Contact.lastname
             
   $Contact.FirstName  = $CurLastName
   $Contact.LastName = $curFirstName
   
   $Contact.Save()

    }

$olApp.Quit | Out-Null
[GC]::Collect()

Saving PowerShell Scripts

If you want to save the script as a .ps1 file, paste it into Notepad and save it with the extension .ps1. To open it in the PowerShell IDE, type powershell on the start menu and click on Windows PowerShell IDE when the PowerShell app is found. Paste the script in the editing window.

To use it, you need to allow local scripts by running this command:

Set-ExecutionPolicy RemoteSigned

To run your saved .ps1 file, right-click on the script and choose Run with PowerShell.

Use PowerShell to Bulk Change Contacts was last modified: October 14th, 2022 by Diane Poremsky

Related Posts:

  • Bulk Change File As Format for Contacts
  • Bulk Change Email Display Name Format
  • Macro to Swap First and Last Name Fields
  • Open Outlook Folders using PowerShell or VBScript

About Diane Poremsky

A Microsoft Outlook Most Valuable Professional (MVP) since 1999, Diane is the author of several books, including Outlook 2013 Absolute Beginners Book. She also created video training CDs and online training classes for Microsoft Outlook. You can find her helping people online in Outlook Forums as well as in the Microsoft Answers and TechNet forums.

Subscribe
Notify of
2 Comments
newest
oldest most voted
Inline Feedbacks
View all comments

Terry Orourke
March 2, 2024 12:37 pm

Hi Diane

Just checked over a few of your Powershell suggestions to amend Outlook email accounts, either names etc I found them very interesting

I would really like something that I can add as an attachment to a number of junk emails that have been sent to me- some very unpleasant- I just want them to click on it and it will remove my name/email from their contacts/list. Please could you help me wit this

0
0
Reply
Diane Poremsky
Author
Reply to  Terry Orourke
March 3, 2024 11:01 am

You don't want to reply to junk mail - that validates your address and you will get more junk.

If its newsletters you signed up for, it is safe to unsubscribe - but never for unsolicited email.

0
0
Reply

Visit Slipstick Forums.
What's New at Slipstick.com

Latest EMO: Vol. 30 Issue 29

Subscribe to Exchange Messaging Outlook






Support Services

Do you need help setting up Outlook, moving your email to a new computer, migrating or configuring Office 365, or just need some one-on-one assistance?

Our Sponsors

CompanionLink
ReliefJet
  • Popular
  • Latest
  • Week Month All
  • Jetpack plugin with Stats module needs to be enabled.
  • Move Deleted Items to Another Folder Automatically
  • Open Outlook Templates using PowerShell
  • Count and List Folders in Classic Outlook
  • Google Workspace and Outlook with POP Mail
  • Import EML Files into New Outlook
  • Opening PST files in New Outlook
  • New Outlook: Show To, CC, BCC in Replies
  • Insert Word Document into Email using VBA
  • Delete Empty Folders using PowerShell
  • Warn Before Deleting a Contact
Ajax spinner

Recent Bugs List

Microsoft keeps a running list of issues affecting recently released updates at Fixes or workarounds for recent issues in classic Outlook (Windows).

For new Outlook for Windows: Fixes or workarounds for recent issues in new Outlook for Windows .

Outlook for Mac Recent issues: Fixes or workarounds for recent issues in Outlook for Mac

Outlook.com Recent issues: Fixes or workarounds for recent issues on Outlook.com

Office Update History

Update history for supported Office versions is at Update history for Office

Outlook Suggestions and Feedback

Outlook Feedback covers Outlook as an email client, including Outlook Android, iOS, Mac, and Windows clients, as well as the browser extension (PWA) and Outlook on the web.

Outlook (new) Feedback. Use this for feedback and suggestions for Outlook (new).

Use Outlook.com Feedback for suggestions or feedback about Outlook.com accounts.

Other Microsoft 365 applications and services




New Outlook Articles

Move Deleted Items to Another Folder Automatically

Open Outlook Templates using PowerShell

Count and List Folders in Classic Outlook

Google Workspace and Outlook with POP Mail

Import EML Files into New Outlook

Opening PST files in New Outlook

New Outlook: Show To, CC, BCC in Replies

Insert Word Document into Email using VBA

Delete Empty Folders using PowerShell

Warn Before Deleting a Contact

Newest Code Samples

Open Outlook Templates using PowerShell

Count and List Folders in Classic Outlook

Insert Word Document into Email using VBA

Warn Before Deleting a Contact

Use PowerShell to Delete Attachments

Remove RE:, FWD:, and Other Prefixes from Subject Line

Change the Mailing Address Using PowerShell

Categorize @Mentioned Messages

Send an Email When You Open Outlook

Delete Old Calendar Events using VBA

VBA Basics

How to use the VBA Editor

Work with open item or selected item

Working with All Items in a Folder or Selected Items

VBA and non-default Outlook Folders

Backup and save your Outlook VBA macros

Get text using Left, Right, Mid, Len, InStr

Using Arrays in Outlook macros

Use RegEx to extract message text

Paste clipboard contents

Windows Folder Picker

Custom Forms

Designing Microsoft Outlook Forms

Set a custom form as default

Developer Resources

Developer Resources

Developer Tools

VBOffice.net samples

SlovakTech.com

Outlook MVP David Lee

Repair PST

Convert an OST to PST

Repair damaged PST file

Repair large PST File

Remove password from PST

Merge Two Data Files

Sync & Share Outlook Data

  • Share Calendar & Contacts
  • Synchronize two computers
  • Sync Calendar and Contacts Using Outlook.com
  • Sync Outlook & Android Devices
  • Sync Google Calendar with Outlook
  • Access Folders in Other Users Mailboxes

Diane Poremsky [Outlook MVP]

Make a donation

Mail Tools

Sending and Retrieval Tools

Mass Mail Tools

Compose Tools

Duplicate Remover Tools

Mail Tools for Outlook

Online Services

Calendar Tools

Schedule Management

Calendar Printing Tools

Calendar Reminder Tools

Calendar Dates & Data

Time and Billing Tools

Meeting Productivity Tools

Duplicate Remover Tools

Productivity

Productivity Tools

Automatic Message Processing Tools

Special Function Automatic Processing Tools

Housekeeping and Message Management

Task Tools

Project and Business Management Tools

Choosing the Folder to Save a Sent Message In

Run Rules on messages after reading

Help & Suggestions

Submit Outlook Feature Requests

Slipstick Support Services

Buy Microsoft 365 Office Software and Services

Visit Slipstick Forums.

What's New at Slipstick.com

Home | Outlook User | Exchange Administrator | Office 365 | Outlook.com | Outlook Developer
Outlook for Mac | Common Problems | Utilities & Addins | Tutorials
Outlook & iCloud Issues | Outlook Apps
EMO Archives | About Slipstick | Slipstick Forums
Submit New or Updated Outlook and Exchange Server Utilities

Send comments using our Feedback page
Copyright © 2025 Slipstick Systems. All rights reserved.
Slipstick Systems is not affiliated with Microsoft Corporation.

:wpds_smile::wpds_grin::wpds_wink::wpds_mrgreen::wpds_neutral::wpds_twisted::wpds_arrow::wpds_shock::wpds_unamused::wpds_cool::wpds_evil::wpds_oops::wpds_razz::wpds_roll::wpds_cry::wpds_eek::wpds_lol::wpds_mad::wpds_sad::wpds_exclamation::wpds_question::wpds_idea::wpds_hmm::wpds_beg::wpds_whew::wpds_chuckle::wpds_silly::wpds_envy::wpds_shutmouth:
wpDiscuz

Sign up for Exchange Messaging Outlook

Our weekly Outlook & Exchange newsletter (bi-weekly during the summer)






Please note: If you subscribed to Exchange Messaging Outlook before August 2019, please re-subscribe.

Never see this message again.

You are going to send email to

Move Comment