outlook-contacts

Outlook Contacts

Manage Microsoft Outlook contacts using PowerShell COM objects.

Prerequisites

• Microsoft Outlook installed and running
• PowerShell 5.1+ (included in Windows 10/11)

List Contacts

outlook-contacts-list.ps1

Browse contacts with optional search filtering. Returns EntryIDs for use with action scripts.

Required Parameters: None (lists all contacts by default)

Parameter	Type	Default	Description
-Limit	int	20	Maximum contacts to display
-Search	string	—	Filter by name, email, or company (case-insensitive)

# List all contacts (first 20)
& "./scripts/outlook-contacts-list.ps1" -Limit 20

# List with search filter
& "./scripts/outlook-contacts-list.ps1" -Search "John"

Search Contacts

outlook-contacts-search.ps1

Search contacts by name, email, and/or company. Multiple criteria use AND logic. Returns EntryIDs for use with action scripts.

Required Parameters: At least one of -Name, -Email, or -Company

Parameter	Type	Default	Description
-Name	string	—	Search by contact name (case-insensitive contains)
-Email	string	—	Search by email address (case-insensitive contains)
-Company	string	—	Search by company name (case-insensitive contains)
-Limit	int	10	Maximum results to return

# Search by name
& "./scripts/outlook-contacts-search.ps1" -Name "John"

# Search by company
& "./scripts/outlook-contacts-search.ps1" -Company "Acme"

# Search by email domain
& "./scripts/outlook-contacts-search.ps1" -Email "example.com"

# Combined search (AND logic)
& "./scripts/outlook-contacts-search.ps1" -Name "John" -Company "Acme"

Create Contact

outlook-contacts-create.ps1

Create a new contact in the default Contacts folder.

Required Parameters: -FullName

Parameter	Type	Default	Description
-FullName	string	Required	Contact's full name
-Email	string	—	Email address
-Phone	string	—	Business phone number
-Mobile	string	—	Mobile phone number
-HomePhone	string	—	Home phone number
-Company	string	—	Company name
-JobTitle	string	—	Job title
-Notes	string	—	Notes/body text

# Create a new contact
& "./scripts/outlook-contacts-create.ps1" -FullName "John Doe" -Email "john@example.com" -Phone "555-1234" -Company "Acme Inc" -JobTitle "Manager"

# Create with mobile and notes
& "./scripts/outlook-contacts-create.ps1" -FullName "Jane Smith" -Email "jane@example.com" -Mobile "555-5678" -Notes "Met at conference"

Update Contact

outlook-contacts-update.ps1

Edit an existing contact's fields. Uses EntryID (preferred) or Index as targeting method.

Required Parameters: -EntryID or -Index, plus at least one field to update

Parameter	Type	Default	Description
-EntryID	string	—	Contact's unique EntryID (preferred, from list/search)
-Index	int	0	Contact position number (fallback)
-FullName	string	—	New full name
-Email	string	—	New email address
-Phone	string	—	New business phone
-Mobile	string	—	New mobile phone
-Company	string	—	New company name
-JobTitle	string	—	New job title
-Notes	string	—	New notes/body text
-Search	string	—	Filter contacts before applying Index (narrows list)

# Update by EntryID (preferred)
& "./scripts/outlook-contacts-update.ps1" -EntryID "00000000..." -Email "newemail@example.com"

# Update by index
& "./scripts/outlook-contacts-update.ps1" -Index 1 -Phone "555-9999" -Company "New Corp"

# Update with search filter
& "./scripts/outlook-contacts-update.ps1" -Index 1 -Search "John" -JobTitle "Director"

Contact Photo

outlook-contacts-photo.ps1

Add or remove a contact's photo. Supports JPG, JPEG, PNG, GIF, BMP formats.

Required Parameters: -EntryID or -Index, plus -PhotoPath or -Remove

Parameter	Type	Default	Description
-EntryID	string	—	Contact's unique EntryID (preferred)
-Index	int	0	Contact position number (fallback)
-PhotoPath	string	—	Path to photo file (JPG, PNG, GIF, BMP)
-Remove	switch	false	Remove existing photo instead of adding
-Search	string	—	Filter contacts before applying Index

# Add photo by EntryID
& "./scripts/outlook-contacts-photo.ps1" -EntryID "00000000..." -PhotoPath "C:\Photos\john.jpg"

# Add photo by index
& "./scripts/outlook-contacts-photo.ps1" -Index 1 -PhotoPath "C:\Photos\john.jpg"

# Remove photo
& "./scripts/outlook-contacts-photo.ps1" -EntryID "00000000..." -Remove

Export Contact

outlook-contacts-export.ps1

Export a contact as vCard (.vcf) file. Default save location is Downloads folder.

Required Parameters: -EntryID or -Index

Parameter	Type	Default	Description
-EntryID	string	—	Contact's unique EntryID (preferred)
-Index	int	0	Contact position number (fallback)
-Path	string	~/Downloads	Save path (file or directory)
-Search	string	—	Filter contacts before applying Index

# Export by EntryID
& "./scripts/outlook-contacts-export.ps1" -EntryID "00000000..."

# Export to specific path
& "./scripts/outlook-contacts-export.ps1" -EntryID "00000000..." -Path "C:\Contacts\john.vcf"

# Export by index
& "./scripts/outlook-contacts-export.ps1" -Index 1

Delete Contact

outlook-contacts-delete.ps1

Delete a contact from Outlook. Supports targeting by EntryID (preferred), Index, or Name.

Required Parameters: One of -EntryID, -Index, or -Name

Parameter	Type	Default	Description
-EntryID	string	—	Contact's unique EntryID (preferred)
-Index	int	0	Contact position number (fallback)
-Name	string	—	Exact full name match (fallback)

# Delete by EntryID (preferred)
& "./scripts/outlook-contacts-delete.ps1" -EntryID "00000000..."

# Delete by index
& "./scripts/outlook-contacts-delete.ps1" -Index 1

# Delete by name
& "./scripts/outlook-contacts-delete.ps1" -Name "John Doe"