Service Pack 2 Preview: Get-NamedProperty

Published Aug 06 2009 04:27 PM 2,487 Views

In today's installment of "Microsoft Exchange Server 2007 Service Pack 2 Preview", I bring you a brief overview of how we are making monitoring named property id usage easier (in the aforementioned service pack 2 - yes, for Exchange Server 2007).

As previously covered here, Exchange Server has the ability to convert x-headers into MAPI NamedProperties. These named properties contain the values of the Xheader for consumption by native MAPI clients who do NOT want to parse the transport headers themselves.

As also covered before, there's a limit on how many of these there can ever be on a single database - 32k. There is also (as mentioned before) no way to recover a named property id once it is distributed.

Rounding out our named property recount, the Information Store (STORE) applies a named property quota which limits how many properties can be handed out. When the quota is exceeded delivering a message with x-headers which can't be created results in those x-headers not being promoted to individual properties. Delivering a message that has a named property which is NOT an x-header and cannot be mapped results in an NDR.

Questions and Answers

There are three basic questions that most admins ask after encountering a named property quota error:

1. How close am I to doom?

2. How fast are my named property ids being consumed (and by who?)

3. If I'm already hosed, what consumed the ids?

The answer is in Service Pack 2 - a new cmdlet, Get-NamedProperty. One cmdlet with three distinct uses, to answer the primary questions for named property promotion.

Get-NamedProperty by default requires a mailbox identity parameter. That's an SMTP address, a guid, a XDSDN (legacyDN) or a LDAP DN for the mailbox object. It runs in one of three mapping modes:

Last: Find the highest named property identifier in use. This is the one I use for monitoring named property growth (we see people use this in scripts to monitor MDBs and adjust the named property quotas appropriately). In this mode you get back the last named property mapped.

New: Find named properties registered since a given id. This one isn't terribly useful unless you already ran get-namedproperty in last mode (the default mode) once. You use it to monitor how fast named property ids are being consumed and where they are coming from. In conjuction with the -StartingPropId parameter, this retrieves only properties mapped since the -StartingPropId.

All: Retrieve all named property mappings. If you are stuck doing analysis of a database which has consumed all named property ids, the number one question is "Why did this happen?" All mode gives you the data you need to answer this. All also requires -Force if you don't want the cmdlet to ask if you really want to retrieve everything.

How to use this

First off, this only exists in Service Pack 2. If you are not running service pack 2 (and you probably aren't, given that it hasn't released yet), wait patiently until it does arrive. Get-NamedProperty is a support namespace cmdlet, meaning that by default you don't see it in the command list. In order to use it, you open an exchange powershell prompt and type:

> Add-PSSnapin Microsoft.Exchange.Management.Powershell.Support

(I modify my Exchange.ps1 in $exbin to do this automatically).

Now Get-NamedProperty will be available and ready to assist in your diagnosis and monitoring.

Let's look at some of the ways we can use it:

PS] C:\SP2Auditing\Perfdata>Get-NamedProperty Administrator | fl

Kind       : String

Guid       : 33eba41f-7aa8-422e-be7b-79e1a98e54b3

Propset    : 33eba41f-7aa8-422e-be7b-79e1a98e54b3

Name       : ConversationIndexTrackingEx

PropertyId : A02E

The last id in use is A02E. Since named property IDs begin at 0x8000, there are 202E properties in use - 8238. Now, we know (from this kb: http://technet.microsoft.com/en-us/library/bb851492.aspx, found by using "Named Property Quota" in a search engine) that by default the named property quota for internet headers is 8192 (0x2000). This MDB will certainly be logging named property quota errors. Now we also know (from the same kb) that the limit for Non MAPI named properties by default is 16384 (0x4000). So while MAPI clients can still map property ids, x-headers are not being promoted to separate named properties.

Get-NamedProperty - coming soon to a support namespace near you. Not changing the world, just making Exchange administration a little easier.

- Jason Nelson

%3CLINGO-SUB%20id%3D%22lingo-sub-599892%22%20slang%3D%22en-US%22%3EService%20Pack%202%20Preview%3A%20Get-NamedProperty%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-599892%22%20slang%3D%22en-US%22%3E%3CP%3E%3C%2FP%3E%3CP%3EIn%20today's%20installment%20of%20%22Microsoft%20Exchange%20Server%202007%20Service%20Pack%202%20Preview%22%2C%20I%20bring%20you%20a%20brief%20overview%20of%20how%20we%20are%20making%20monitoring%20named%20property%20id%20usage%20easier%20(in%20the%20aforementioned%20service%20pack%202%20-%20yes%2C%20for%20Exchange%20Server%202007).%3C%2FP%3E%20%3CP%3EAs%20previously%20covered%20%3CA%20title%3D%22http%3A%2F%2Fmsexchangeteam.com%2Farchive%2F2009%2F06%2F12%2F451596.aspx%22%20href%3D%22http%3A%2F%2Fmsexchangeteam.com%2Farchive%2F2009%2F04%2F06%2F451003.aspx%22%20rel%3D%22nofollow%20noopener%20noreferrer%22%20target%3D%22_blank%22%3Ehere%2C%3C%2FA%3E%20Exchange%20Server%20has%20the%20ability%20to%20convert%20x-headers%20into%20MAPI%20NamedProperties.%20These%20named%20properties%20contain%20the%20values%20of%20the%20Xheader%20for%20consumption%20by%20native%20MAPI%20clients%20who%20do%20NOT%20want%20to%20parse%20the%20transport%20headers%20themselves.%3C%2FP%3E%3CP%3EAs%20also%20covered%20%3CA%20href%3D%22http%3A%2F%2Fmsexchangeteam.com%2Farchive%2F2009%2F04%2F06%2F451003.aspx%22%20rel%3D%22nofollow%20noopener%20noreferrer%22%20target%3D%22_blank%22%3Ebefore%3C%2FA%3E%2C%20there's%20a%20limit%20on%20how%20many%20of%20these%20there%20can%20ever%20be%20on%20a%20single%20database%20-%2032k.%20There%20is%20also%20(as%20mentioned%20before)%20no%20way%20to%20recover%20a%20named%20property%20id%20once%20it%20is%20distributed.%3C%2FP%3E%3CP%3ERounding%20out%20our%20named%20property%20recount%2C%20the%20Information%20Store%20(STORE)%20applies%20a%20named%20property%20quota%20which%20limits%20how%20many%20properties%20can%20be%20handed%20out.%20When%20the%20quota%20is%20exceeded%20delivering%20a%20message%20with%20x-headers%20which%20can't%20be%20created%20results%20in%20those%20x-headers%20not%20being%20promoted%20to%20individual%20properties.%20Delivering%20a%20message%20that%20has%20a%20named%20property%20which%20is%20NOT%20an%20x-header%20and%20cannot%20be%20mapped%20results%20in%20an%20NDR.%3C%2FP%3E%3CH3%20id%3D%22toc-hId-1088195093%22%20id%3D%22toc-hId-1118586557%22%3E%3CSTRONG%3EQuestions%20and%20Answers%3C%2FSTRONG%3E%3C%2FH3%3E%20%3CP%3EThere%20are%20three%20basic%20questions%20that%20most%20admins%20ask%20after%20encountering%20a%20named%20property%20quota%20error%3A%3C%2FP%3E%3CP%3E1.%20How%20close%20am%20I%20to%20doom%3F%3C%2FP%3E%3CP%3E2.%20How%20fast%20are%20my%20named%20property%20ids%20being%20consumed%20(and%20by%20who%3F)%3C%2FP%3E%3CP%3E3.%20If%20I'm%20already%20hosed%2C%20what%20consumed%20the%20ids%3F%3C%2FP%3E%3CP%3EThe%20answer%20is%20in%20Service%20Pack%202%20-%20a%20new%20cmdlet%2C%20Get-NamedProperty.%20One%20cmdlet%20with%20three%20distinct%20uses%2C%20to%20answer%20the%20primary%20questions%20for%20named%20property%20promotion.%3C%2FP%3E%3CP%3EGet-NamedProperty%20by%20default%20requires%20a%20mailbox%20identity%20parameter.%20That's%20an%20SMTP%20address%2C%20a%20guid%2C%20a%20XDSDN%20(legacyDN)%20or%20a%20LDAP%20DN%20for%20the%20mailbox%20object.%20It%20runs%20in%20one%20of%20three%20mapping%20modes%3A%3C%2FP%3E%3CP%3ELast%3A%20Find%20the%20highest%20named%20property%20identifier%20in%20use.%20This%20is%20the%20one%20I%20use%20for%20monitoring%20named%20property%20growth%20(we%20see%20people%20use%20this%20in%20scripts%20to%20monitor%20MDBs%20and%20adjust%20the%20named%20property%20quotas%20appropriately).%20In%20this%20mode%20you%20get%20back%20the%20last%20named%20property%20mapped.%3C%2FP%3E%3CP%3ENew%3A%20Find%20named%20properties%20registered%20since%20a%20given%20id.%20This%20one%20isn't%20terribly%20useful%20unless%20you%20already%20ran%20get-namedproperty%20in%20last%20mode%20(the%20default%20mode)%20once.%20You%20use%20it%20to%20monitor%20how%20fast%20named%20property%20ids%20are%20being%20consumed%20and%20where%20they%20are%20coming%20from.%20In%20conjuction%20with%20the%20-StartingPropId%20parameter%2C%20this%20retrieves%20only%20properties%20mapped%20since%20the%20-StartingPropId.%3C%2FP%3E%3CP%3EAll%3A%20Retrieve%20all%20named%20property%20mappings.%20If%20you%20are%20stuck%20doing%20analysis%20of%20a%20database%20which%20has%20consumed%20all%20named%20property%20ids%2C%20the%20number%20one%20question%20is%20%22Why%20did%20this%20happen%3F%22%20All%20mode%20gives%20you%20the%20data%20you%20need%20to%20answer%20this.%20All%20also%20requires%20-Force%20if%20you%20don't%20want%20the%20cmdlet%20to%20ask%20if%20you%20really%20want%20to%20retrieve%20everything.%3C%2FP%3E%3CH3%20id%3D%22toc-hId--719259370%22%20id%3D%22toc-hId--688867906%22%3E%3CSTRONG%3EHow%20to%20use%20this%3C%2FSTRONG%3E%3C%2FH3%3E%20%3CP%3EFirst%20off%2C%20this%20only%20exists%20in%20Service%20Pack%202.%20If%20you%20are%20not%20running%20service%20pack%202%20(and%20you%20probably%20aren't%2C%20given%20that%20it%20hasn't%20released%20yet)%2C%20wait%20patiently%20until%20it%20does%20arrive.%20Get-NamedProperty%20is%20a%20support%20namespace%20cmdlet%2C%20meaning%20that%20by%20default%20you%20don't%20see%20it%20in%20the%20command%20list.%20In%20order%20to%20use%20it%2C%20you%20open%20an%20exchange%20powershell%20prompt%20and%20type%3A%3C%2FP%3E%3CP%3E%3CFONT%20face%3D%22Courier%22%3E%26gt%3B%20Add-PSSnapin%20Microsoft.Exchange.Management.Powershell.Support%3C%2FFONT%3E%3C%2FP%3E%3CP%3E(I%20modify%20my%20Exchange.ps1%20in%20%24exbin%20to%20do%20this%20automatically).%3C%2FP%3E%3CP%3ENow%20Get-NamedProperty%20will%20be%20available%20and%20ready%20to%20assist%20in%20your%20diagnosis%20and%20monitoring.%3C%2FP%3E%3CP%3ELet's%20look%20at%20some%20of%20the%20ways%20we%20can%20use%20it%3A%3C%2FP%3E%3CP%3E%3CFONT%20face%3D%22Courier%22%3EPS%5D%20C%3A%5CSP2Auditing%5CPerfdata%26gt%3BGet-NamedProperty%20Administrator%20%7C%20fl%3C%2FFONT%3E%3C%2FP%3E%3CP%3E%3CFONT%20size%3D%222%22%20face%3D%22Courier%22%3EKind%26nbsp%3B%26nbsp%3B%26nbsp%3B%26nbsp%3B%26nbsp%3B%26nbsp%3B%20%3A%20String%3C%2FFONT%3E%3C%2FP%3E%3CP%3E%3CFONT%20size%3D%222%22%20face%3D%22Courier%22%3EGuid%26nbsp%3B%26nbsp%3B%26nbsp%3B%26nbsp%3B%26nbsp%3B%26nbsp%3B%20%3A%2033eba41f-7aa8-422e-be7b-79e1a98e54b3%3C%2FFONT%3E%3C%2FP%3E%3CP%3E%3CFONT%20size%3D%222%22%20face%3D%22Courier%22%3EPropset%26nbsp%3B%26nbsp%3B%26nbsp%3B%20%3A%2033eba41f-7aa8-422e-be7b-79e1a98e54b3%3C%2FFONT%3E%3C%2FP%3E%3CP%3E%3CFONT%20size%3D%222%22%20face%3D%22Courier%22%3EName%26nbsp%3B%26nbsp%3B%26nbsp%3B%26nbsp%3B%26nbsp%3B%26nbsp%3B%20%3A%20ConversationIndexTrackingEx%3C%2FFONT%3E%3C%2FP%3E%3CP%3E%3CFONT%20size%3D%222%22%20face%3D%22Courier%22%3EPropertyId%20%3A%20A02E%3C%2FFONT%3E%3C%2FP%3E%3CP%3EThe%20last%20id%20in%20use%20is%20A02E.%20Since%20named%20property%20IDs%20begin%20at%200x8000%2C%20there%20are%20202E%20properties%20in%20use%20-%208238.%20Now%2C%20we%20know%20(from%20this%20kb%3A%20%3CA%20href%3D%22http%3A%2F%2Ftechnet.microsoft.com%2Fen-us%2Flibrary%2Fbb851492.aspx%22%20rel%3D%22noopener%20noreferrer%22%20target%3D%22_blank%22%3Ehttp%3A%2F%2Ftechnet.microsoft.com%2Fen-us%2Flibrary%2Fbb851492.aspx%3C%2FA%3E%2C%20found%20by%20using%20%22Named%20Property%20Quota%22%20in%20a%20search%20engine)%20that%20by%20default%20the%20named%20property%20quota%20for%20internet%20headers%20is%208192%20(0x2000).%20This%20MDB%20will%20certainly%20be%20logging%20named%20property%20quota%20errors.%20Now%20we%20also%20know%20(from%20the%20same%20kb)%20that%20the%20limit%20for%20Non%20MAPI%20named%20properties%20by%20default%20is%2016384%20(0x4000).%20So%20while%20MAPI%20clients%20can%20still%20map%20property%20ids%2C%20x-headers%20are%20not%20being%20promoted%20to%20separate%20named%20properties.%3C%2FP%3E%3CP%3EGet-NamedProperty%20-%20coming%20soon%20to%20a%20support%20namespace%20near%20you.%20Not%20changing%20the%20world%2C%20just%20making%20Exchange%20administration%20a%20little%20easier.%3C%2FP%3E%3CP%3E-%20Jason%20Nelson%3C%2FP%3E%3C%2FLINGO-BODY%3E
Version history
Last update:
‎Aug 06 2009 04:27 PM
Updated by: