How to Add Proxy Addresses in Active Directory

Need to add a proxy address to a user account in Active Directory?

In this guide, I’ll show you how to add proxy addresses using Active Directory Users and Computers, PowerShell, and the AD Pro Toolkit.

I’ll also cover how to bulk add and remove proxy addresses using a CSV file.

Table of Contents

Add Proxy Address using Active Directory Users and Computers

Step 1. Make sure Advanced Features are enabled by clicking View > Advanced Features

aduc advanced features

Step 2. Browse to a user and open the account properties

Step 3. Select the “Attribute Editor” tab.

aduc attribute editor

Step 4. Select the proxyAddresses attribute and click edit.

Step 5. In the value to add enter the proxy address and click the add button.

Note: Use capital SMTP to set a primary address. Only one primary can be set the others must be lowercase smtp.

aduc proxyaddresses attribute

Add Proxy Address with PowerShell

To add ProxyAddresses with PowerShell you would use the set-aduser cmdlet.

Set-ADUser Abbie.Peters -add @{ProxyAddresses="smtp:Abbie.Peters2.activedirectorypro.com"}

In the above example, I’m adding a new proxyaddress to user Abbie.Peters.

You can view the users proxyAddresses in Active Directory by clicking on the attribute editor and then the proxyAddresses attribute.

active directory proxyaddresses with powershell

To remove proxyaddresses with PowerShell use the -remove parameter.

Set-ADUser Abbie.Peters -remove @{ProxyAddresses="smtp:Abbie.Peters2.activedirectorypro.com"}

Bulk Add Proxy Addresses with AD Pro Toolkit

If you need to add or modify proxy addresses for multiple users then the AD Pro Toolkit the easiest option.

Download AD Pro Toolkit and give it a try.

Step 1. Select Users

You can either click “Browse AD” and select accounts or use a list from a CSV file.

add proxyaddress with ad pro toolkit

Step 2. Choose Action

Choose to “Add Proxy Address” or “Find & Replace”.

In this example, I’m going to add a proxy address to multiple users.

select users to update

Step 3. Click Preview

You can click “Preview Changes” to see what the changes will be.

preview proxyaddress changes

If the preview looks good, click “Apply Changes”.

Find and Replace ProxyAddresses

The AD Pro Toolkit also has a find and replace feature.

Enter the text you want to find and text to replace it with. For example, I want to replace the domain entralyzer.com with entralyer2.com

find and replace proxyaddresses

Export User Proxy Addresses with PowerShell

To get a list of all users proxyAddresses use the below PowerShell command.

get-aduser -filter * -properties proxyaddresses | select samaccountname, proxyaddresses
powershell get proxyaddresses

With the AD Pro Toolkit click add the Proxy Addresses column to any report.

Click the export button to export the report.

ad pro toolkit list proxyaddresses

If you are using Azure AD connect or Office 365 then knowing how to bulk update users ProxyAddresses attribute is a must. In this guide, I showed you multiple examples for updating single accounts, adding multiple addresses, and bulk updating a list of accounts from a CSV file

PowerShell is a great tool for making mass changes to Active Directory users but for those that want a GUI option, the AD Bulk User Update tool is a simple and easy solution. 

Let me know in the comments below if you have any questions. 

Related Articles