Docs / Modify ProxyAddresses

Modify ProxyAddress for multiple Active Directory users

In this guide, I’ll show you how to add, change, and remove ProxyAddresses using the AD Pro Toolkit. This will update the proxyAddresses attribute for on-premise Active Directory user accounts.

Warning:

  1. It is recommended to test updating a few accounts first to make sure the proxyAddresses update as needed. After verifying the accounts update correctly, then proceed with making bulk proxyAddress updates.
  2. Before making bulk changes to user accounts, create a backup of the user attributes. Run the All Users report and add the attributes that you want to change such as ProxyAddresses. Then export the report to a CSV file. This will give you a backup of the user attributes so you can refer to it if needed.

How to Add New ProxyAddresses to multiple user accounts.

In this example, I’ll add new proxyaddresses to user accounts. To update or replace proxyaddresses see the next section.

  1. Download the Add New ProxyAddress Template
  2. Fill out the CSV with user and proxyaddress information CSV Example.If you need to add multiple proxyaddresses seperate them with a comma.
  3. Open the bulk modify user tool
  4. Click on “Update Options” and make sure “Add New” is selected.
  5. Select your CSV file and click run.

Check the logs for any errors.

Update Existing ProxyAddresses

If an account has a proxyAddress that you want to update use these steps.

  1. Download the Update existing ProxyAddress Template
  2. Fill out the csv with the target account and addresses you want to update.
    • sAMAccountName = Target user account
    • proxyAddresses = Target proxyaddress for the account you want to update
    • proxyAddresses_update = This will replace what is in the proxyAddresses column.
  3. Open the bulk modify user tool.
  4. Click on “Update Options” and make sure “Update Existing” is selected.
  5. Select your csv file and click run.

Remove All ProxyAddresses

Warning: This will remove all user’s proxyAddresses. I recommend running the All Users report first and exporting the proxyAddresses to a CSV file. This will give you a backup of the user settings in case you need to revert.

  1. Put remove in the proxyAddress column.
  2. Open the bulk modify user tool.
  3. In the options “Add New” should be selected. Although you are not adding new proxyAddresses this option must be set to remove the addresses.
  4. Select your csv file and click run.