Welcome to Exchange Team Blog Sign in | Join | Help

Syndication

This Blog

GAL Photos: Frequently Asked Questions

Earlier I posted about the new GAL Photos feature in Exchange 2010 and Outlook 2010. Since then, there have been many implementation-related questions internally and from customers.

Here are some FAQs

Q. Do I need Exchange 2010 to display GAL Photos?
A. As noted in the post, Active Directory has the thumbnailPhoto attribute. Outlook 2010 has the client-side feature to display the photo. Exchange 2010 provides the Import-RecipientDataProperty cmdlet to easily import the picture (yes, a GUI would've been nice - we hear ya!), and Exchange 2010's Offline Address Book (OAB) has the ability to include the necessary pointers to AD to allow Cached Mode clients to display the picture - the client still needs to be able to communicate to AD to download the picture. You can make it work for Outlook 2010 clients without using Exchange 2010, but Cached Mode support is an Exchange 2010 + Outlook 2010 feature.

If you can write the code/script to upload the picture blob to AD (or find the script/code on the web), you can make it work with a previous version of Exchange. We recommend you treat all scripts/code downloaded from the web as untrusted code and test it thoroughly in a non-production environment.

Q. What are Active Directory requirements? Do I need Windows 2008 R2?
A. Windows 2008 R2 is not required. In fact, the thumbnailPhoto attribute has been around since Windows 2000.
- However, the mAPIID attribute should have the value 35998. This happens when domain controllers are running Windows 2008 or later, or if your Active Directory schema has been updated to Windows 2008. If not, you can run forestprep from Windows 2008 to update it. For details, check out Prepare a Windows 2000 or Windows Server 2003 Forest Schema for a Domain Controller That Runs Windows Server 2008 or Windows Server 2008 R2. In an environment with mutliple forests, you must update each forest that has users or Exchange servers.
- You must set the thumbnailPhoto attribute to replicate to the Global Catalog, as shown in the original post, although it'll work without this modification in single domain environments.

Q. Is the thumbnail saved in my OAB?
A. No, by default it isn't. As noted in the previous post, the Exchange 2010 OAB simply includes a pointer that the data exists in AD. You can modify it to include the photo blob in the OAB. We recommend testing it in a non-production environment to determine, depending on the number of users in your organization, whether you can support the resulting OAB size.

Q. How can I add the thumbnail to my OAB?
A. Remove the thumbnailPhoto attribute as an Indicator attribute from the OAB using the following code (also provided in the original post):

$attributes = (Get-OfflineAddressBook "Default Offline Address Book").ConfiguredAttributes
$attributes.Remove("thumbnailphoto,Indicator")
Set-OfflineAddressBook "Default Offline Address Book" -ConfiguredAttributes $attributes

Add the attribute as a Value attribute:

$attributes.Add("thumbnailphoto,Value")
Set-OfflineAddressBook "Default Offline Address Book" -ConfiguredAttributes $attributes

Remember to update the OAB once you're done uploading photos.

Update-OfflineAddressBook "Default Offline Address Book"

Q. Does Outlook 2010 cache the photos?
A. Outlook 2010 caches the photos for the session so it doesn't pull the data from Active Directory again during that session. If Outlook 2010 doesn't have Active Directory connectivity, and the thumbnailPhoto attribute isn't included as a Value attribute in the Offline Address Book, it won't display the thumbnail.

Q. Can Outlook 2007 display GAL photos?
A. No, Outlook 2007 displays photos for Contacts if the user has saved them. This is a client-side feature and no data is uploaded to AD. For details, see Add, change, or remove a picture for a contact.

Q. When users send an email to external recipients, are photos sent outside my organization?
A. No, the thumbnail photos are not sent with email. As indicated above, Outlook 2010 clients in your organization fetch the data from Active Directory (or the Offline Address Book, if you've modified the ConfiguredAttributes parameter for the OAB to include it as a value attribute). If your Active Directory is accessible to anonymous users from outside the organization, meet me at camera 2! :)

-- Bharat Suneja

Published Tuesday, June 01, 2010 11:00 AM by Exchange
Filed Under: , ,

Comments

 

Constantino Tobio said:

I have this all working, except I don't think I have the photos in my GAL despite having done what's in the instructions. I have not upgraded my schema to 2008 yet, however. Everything else is working (photos in the contact card, etc). Is not having the schema updated the cause of not having the photos actually be present in the GAL?
June 1, 2010 2:24 PM
 

Mike C said:

Nice article.  Any support for OWA 2010 in sp1?
June 1, 2010 2:24 PM
 

Mike C said:

When a user has a local photo and AD has a photo for the same person, how is this handled?

If the GAL has a conflicting phone number for a user this only matters when the record is pulled up, but pictures are shown when messages arrive.
June 1, 2010 2:29 PM
 

Mike C said:

Constantino, as you'll see above you do need to update the schema to adjust the mAPIID attribute.  You can do this without actually upgrading your domain controllers.
June 1, 2010 2:30 PM
 

Exchange said:

@Constantino Tobio: You must update the schema to populate the MapiID for Outlook 2010 to show these.
June 1, 2010 4:28 PM
 

Tobie Fysh said:

@MikeC The locally saved photo is used.

We have had photos in AD for years! Nice to see MS using AD finally using this in a product. We use rDirectory from www.Namescape.com to empower our end users to take control of their data and upload their own photos.  
June 2, 2010 1:34 AM
 

Ozgur said:

Can we add photos to distribution groups?
June 2, 2010 10:56 AM
 

Bharat Suneja [MSFT] said:

@Ozgur: If you look at the Identity parameter in Import-RecipientDataProperty cmdlet, the parameter type is Microsoft.Exchange.Configuration.Tasks.MailboxUserContactIdParameter. This means it'll only accept a mailbox user or Contact, and you can't specify a distribution group.
June 9, 2010 2:06 AM
 

Patrick Hoban said:

I've ran 2008 R2 adprep32 (forestprep & domainprep) but the value of mAPIID is still 32974. Is there anything else that needs to be done to get the value to 35998?
June 12, 2010 3:29 PM
 

Patrick Hoban said:

Nevermind. I was looking at the actual mAPPID attribute & not the mAPPID attribute of the picture attribute. It's correct.
June 13, 2010 12:48 PM
 

Uwe said:

Environment: DC 2003 & Ex2003  & Outlook 2010.

How to set the mAPIID attribute to value 35998 without ForestPrep ?
it is possible to set it manually ?
June 15, 2010 4:23 AM
 

El Kabong said:

Great article.  I can populate this attribute for users (found a PS1 script that will do it w/o E14, btw), but we are also wanting it for our Distribution Groups.  When I use OL 2010 I see the thumbnails (& the placeholder icons) for the users.  These placeholders exist for Distribution Groups, too.  Why no picture capability?  I checked ADSIEdit and found that the 'thumbnailPhoto' is not, by default, an attribute of the 'group' AD class.  If I want to enable this for groups, couldn't I just manually extend the Schema by adding the 'thumbnailPhoto' as an attribute of the AD 'Group' Class?  I checked and it seems like it would work.  I  know I'm not the only one that will be wanting this.
Thoughts?
Thanks
June 15, 2010 11:19 AM
 

Tomas said:

Hi
I have small problem
I setup  thumbnailphoto as value but I see picture only when J'm useing online mode not in Cached Mode.


June 22, 2010 6:28 AM
 

Bharat Suneja [MSFT] said:

@Tomas: Was the OAB updated after changing value types? Did the client download the new OAB?

@El Kabong: Thanks for the feedback. As with all schema changes, make sure you test it thoroughly in a lab environment.

@Uwe: Is there an issue with updating schema using Forestprep?
June 22, 2010 12:35 PM
 

Tomas said:

OAB is downloaded but I overlook schema update. ( ithink this is problem)
But I see picture when I compose a message and choose the recipient nad I hover over the recipient's name
June 23, 2010 5:28 AM
 

Jon said:

How large an image can be uploaded and does it mean that the size of ad will expand to equal the amount of image sizes uploaded ?
June 25, 2010 5:47 AM
 

Marc said:

I have been through the steps and I see the photos in various spots within Outlook 2010, but not in the top, right corner of a message from another internal sender. If the people pane is on, the photo appears at the bottom, but rarely is this used. Anything more need to be done in order to get the photos to display within a message?
July 21, 2010 3:11 PM
 

Regis said:

Who can I remove a picture (one user is not happy with his face ...) I'm sure it is an AD atribute but I can't find it.
July 25, 2010 2:33 AM
 

LarryMoore said:

We are using the thumbnailPhoto attribute. Works fine. Does Outlook 2010 /Exchange 2010 use the jpegPhoto attribute for anything?
August 10, 2010 11:04 AM
 

toplum said:

sure hope inplace will be possible. lots of customers want that.
August 21, 2010 9:04 AM
New Comments to this post are disabled

News

Exchange 2010 Trial download

This blog and its contents are provided "AS IS" with no warranties, and they confer no rights. Use of any included script samples are subject to the terms specified in the Terms of Use.


EHLO Idea
Would you like to suggest a topic for the Exchange team to blog about? Send suggestions to us.

Poll:

Other Exchange Blogs from MSFT