{"id":69843,"date":"2005-05-10T16:55:00","date_gmt":"2005-05-10T16:55:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2005\/05\/10\/how-can-i-add-an-email-address-to-the-proxyaddresses-attribute\/"},"modified":"2005-05-10T16:55:00","modified_gmt":"2005-05-10T16:55:00","slug":"how-can-i-add-an-email-address-to-the-proxyaddresses-attribute","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/how-can-i-add-an-email-address-to-the-proxyaddresses-attribute\/","title":{"rendered":"How Can I Add an Email Address to the proxyAddresses Attribute?"},"content":{"rendered":"

\"Hey, <\/H2>\n

Hey, Scripting Guy! How can I add an email address to the proxyAddresses attribute without overwriting all the existing attributes?

— DH<\/P>\"Spacer\"\"Hey,\"Script<\/A> \n

Hey, DH. For those of you who aren\u2019t too familiar with the proxyAddresses attribute (and, alas, that includes the Scripting Guys) proxyAddresses is an attribute added to Active Directory by Microsoft Exchange; it\u2019s simply an alias by which an Exchange user can be recognized by a non-Exchange mail system. If you echo back the proxy addresses for a given user you\u2019re likely to see something similar to this:<\/P>

NUMERIC:4257050743\nsip:kenmyer@fabrikam.com\nX500:\/o=fabrikam\/ou=APPS-WGA\/cn=Xenix_Users\/cn=kenmyer\nX500:\/o=fabrikam\/ou=First Administrative Group\/cn=Recipients\/cn=kenmyer\nx400:c=US;a=MCI;p=fab;o=northamerica;s=Myer;g=Ken;\nX500:\/O=fabrikam\/OU=northamerica\/cn=Recipients\/cn=kenmyer\nX400:c=US;a=finance;p=fabrikam;o=fabrikam;s=Myer;g=Ken;\nx500:\/o=fabrikam\/ou=northamerica\/cn=Recipients\/cn=556899\nsmtp:kenmyer@fabrikam.com\nSMTP:kenmyer@finance.fabrikam.com\n<\/PRE>\n
If you\u2019re thinking, \u201cWow, that\u2019s s lot of stuff for one little attribute to have,\u201d well, that\u2019s because proxyAddresses happens to be a multi-valued attribute, an attribute that can contain more than one value. And that\u2019s why this particular question is so tricky. Suppose we wanted to add a new proxy address – kenmyer@northamerica.fabrikam.com – to the list of proxyAddresses. We don\u2019t want to delete the existing addresses; we just want to add an additional one.<\/P>\n
Hey, no problem; after all, everyone knows how to modify an Active Directory attribute, right? And so you try a script similar to this:<\/P>
Set objUser = GetObject _\n    (“LDAP:\/\/atl-dc-1\/CN=Ken Myer,OU=Finance,DC=fabrikam,DC=com”)\nobjUser.proxyAddresses = kenmyer@northamerica.fabrikam.com\nobjUser.SetInfo\n<\/PRE>\n
And guess what you get back the next time you echo Ken Myer\u2019s proxy addresses:<\/P>
kenmyer@northamerica.fabrikam.com\n<\/PRE>\n
Uh-oh: we deleted all the old proxy addresses and replaced<\/I> them with the new address. Not what we wanted to do at all.<\/P>\n
So how can we simply tack an additional value onto the end of a multi-valued attribute? Why, we just need to use the PutEx<\/B> method:<\/P>
Const ADS_PROPERTY_APPEND = 3<\/p>\n
Set objUser = GetObject _\n    (“LDAP:\/\/cn=KenMyer,ou=Finance,dc=fabrikam,dc=com”) <\/p>\n
objUser.PutEx ADS_PROPERTY_APPEND, “proxyAddresses”, _\n    Array(“kenmyer@northamerica.fabrikam.com “)\n<\/PRE>\n
PutEx is an ADSI method designed for working with multi-valued attributes; in fact, PutEx offers four different options for working with multi-valued attributes:<\/P>\n\n<\/THEAD>\n\n\n\n\n\n\n
\n
Constant<\/B><\/P><\/TD>\n
\n
Value<\/B><\/P><\/TD>\n
\n
Description<\/B><\/P><\/TD><\/TR>\n
\n
ADS_PROPERTY_CLEAR<\/P><\/TD>\n
\n
1<\/P><\/TD>\n
\n
Clears the value (or values) from the specified attribute.<\/P><\/TD><\/TR>\n
\n
ADS_PROPERTY_UPDATE<\/P><\/TD>\n
\n
2<\/P><\/TD>\n
\n
Replaces the value in the specified attribute with new values.<\/P><\/TD><\/TR>\n
\n
ADS_PROPERTY_APPEND<\/P><\/TD>\n
\n
3<\/P><\/TD>\n
\n
Appends a new value (or values) to the specified attribute.<\/P><\/TD><\/TR>\n
\n
ADS_PROPERTY_DELETE<\/P><\/TD>\n
\n
4<\/P><\/TD>\n
\n
Deletes the value (or values) from the specified attribute.<\/P><\/TD><\/TR><\/TBODY><\/TABLE>\n
<\/DIV>\n
We won\u2019t spend a lot of time detailing how PutEx works; for more information you might check out the Modifying Multivalued Attributes<\/B><\/A> section in the Microsoft Windows 2000 Scripting Guide<\/I>.<\/P>\n
Now, back to our script. We want to append a new value to proxyAddresses; consequently in the first line of the script we define a constant named ADS_PROPERTY_APPEND and set the value to 3:<\/P>
Const ADS_PROPERTY_APPEND = 3\n<\/PRE>\n
We bind to the Ken Myer user account and then call the PutEx method, passing three parameters:<\/P>\n\n\n\n\n\n
\u2022<\/TD>\n\n
The constant ADS_PROPERTY_APPEND, which tells the script to append<\/I> the new value to any existing values.<\/P><\/TD><\/TR>\n
\u2022<\/TD>\n\n
The name of the attribute we want to work with (proxyAddresses).<\/P><\/TD><\/TR>\n
\u2022<\/TD>\n\n
The value we want to append (in other words, the new proxy address).<\/P><\/TD><\/TR><\/TBODY><\/TABLE>\n
Note that even though we\u2019re adding only a single value we need to pass that value as an array; hence our actual code looks like this:<\/P>
objUser.PutEx ADS_PROPERTY_APPEND, “proxyAddresses”, _\n    Array(“kenmyer@northamerica.fabrikam.com”)\n<\/PRE>\n
And what do we get when we echo the proxy addresses for Ken Myer:<\/P>
kenmyer@northamerica.fabrikam.com \nNUMERIC:4257050743\nsip:kenmyer@fabrikam.com\nX500:\/o=fabrikam\/ou=APPS-WGA\/cn=Xenix_Users\/cn=kenmyer\nX500:\/o=fabrikam\/ou=First Administrative Group\/cn=Recipients\/cn=kenmyer\nx400:c=US;a=MCI;p=fab;o=northamerica;s=Myer;g=Ken;\nX500:\/O=fabrikam\/OU=northamerica\/cn=Recipients\/cn=kenmyer\nX400:c=US;a=finance;p=fabrikam;o=fabrikam;s=Myer;g=Ken;\nx500:\/o=fabrikam\/ou=northamerica\/cn=Recipients\/cn=556899\nsmtp:kenmyer@fabrikam.com\nSMTP:kenmyer@finance.fabrikam.com\n<\/PRE>\n
Cool, huh?<\/P>\n
Incidentally, there\u2019s no guarantee that the new proxy address will show up first in the list of addresses; when it comes to multi-valued attributes the order of the individual attributes is not guaranteed. But that doesn\u2019t matter just as long as kenmyer@northamerica.fabrikam.com shows up somewhere<\/I> in the list.<\/P><\/p>\n","protected":false},"excerpt":{"rendered":"
Hey, Scripting Guy! How can I add an email address to the proxyAddresses attribute without overwriting all the existing attributes?— DH Hey, DH. For those of you who aren\u2019t too familiar with the proxyAddresses attribute (and, alas, that includes the Scripting Guys) proxyAddresses is an attribute added to Active Directory by Microsoft Exchange; it\u2019s simply […]<\/p>\n","protected":false},"author":595,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[7,27,28,29,200,3,20,5],"class_list":["post-69843","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-active-directory","tag-exchange","tag-messaging-and-communication","tag-microsoft-exchange-2003","tag-microsoft-exchange-2007","tag-scripting-guy","tag-user-accounts","tag-vbscript"],"acf":[],"blog_post_summary":"
Hey, Scripting Guy! How can I add an email address to the proxyAddresses attribute without overwriting all the existing attributes?— DH Hey, DH. For those of you who aren\u2019t too familiar with the proxyAddresses attribute (and, alas, that includes the Scripting Guys) proxyAddresses is an attribute added to Active Directory by Microsoft Exchange; it\u2019s simply […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/69843","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/595"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=69843"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/69843\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=69843"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=69843"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=69843"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}