Show the Features of Room and Equipment Mailboxes using the Resource Schema

When some organizations create room and equipment mailboxes they use a naming convention to show end users what capabilities that resource has.

For example, a conference room is named “Brisbane Lvl 1 Conference Room – Video Conferencing” to indicate that it contains video conferencing equipment.

But that can get messy if a room has several features. Imagine naming your room mailbox “Brisbane Lvl 1 Conference Room – Video Conferencing, Coffee Machine, Whiteboard”.

Another way to achieve the same result is to use the resource schema feature of Exchange Server 2013. The resource schema provides the capability for administrators to show interesting features of resource mailboxes.

For example, room mailboxes can be shown to have whiteboards, video conferencing equipment, or coffee facilities.

The default resource schema can been seen by running Get-ResourceConfig, and contains no entries, so it is something that you will need to build from scratch.

[PS] C:\>Get-ResourceConfig

Name                      ResourcePropertySchema
----                      ----------------------
Resource Schema           {}

When you add entries to the resource schema they must all begin with either “Room/” or “Equipment/” to indicate which resource mailbox type they are to be used with.

Let’s take a look at an example of adding an entry for a whiteboard in meeting rooms. Assuming the resource schema is empty to begin with we can simply use Set-ResourceConfig.

[PS] C:\>Set-ResourceConfig -ResourcePropertySchema "Room/Whiteboard"

[PS] C:\>Get-ResourceConfig

Name                      ResourcePropertySchema
----                      ----------------------
Resource Schema           {Room/Whiteboard}

Adding entries to the resource schema doesn’t add them to any resource mailboxes. That is the next step of the process, using Set-Mailbox.

[PS] C:\>Set-Mailbox "Brisbane Lvl 1 Conference Room" -ResourceCustom "Whiteboard"

Notice that we don’t need to use use “Room/Whiteboard” in this example, just “Whiteboard”. We also can’t simply add a custom resource entry that has not already been defined in the resource schema.

[PS] C:\>Set-Mailbox "Brisbane Lvl 1 Conference Room" -ResourceCustom "Video Conferencing"
The resource search property value "VideoConferencing" is not valid.

To add more entries to a resource schema that already has at least one entry in it we simply append it.

[PS] C:\>Set-ResourceConfig -ResourcePropertySchema @{Add="Room/VideoConferencing"}

[PS] C:\>Get-ResourceConfig

Name                      ResourcePropertySchema
----                      ----------------------
Resource Schema           {Room/VideoConferencing, Room/Whiteboard}

To add another entry from the resource schema to a mailbox that already has custom resource entries we use the same technique to append it.

[PS] C:\>Set-Mailbox "Brisbane Lvl 1 Conference Room" -ResourceCustom @{Add="VideoConferencing"}

The benefit for end users is that they can see these resource capabilities in the description of the mailbox when they are booking a meeting request, and your mailbox names do not get out of control.

Exchange 2013 Resource Schema Example

About Paul Cunningham

Paul is a Microsoft Exchange Server MVP and publisher of Exchange Server Pro. He also holds several Microsoft certifications including for Exchange Server 2007, 2010 and 2013. Connect with Paul on Twitter and Google+.

Comments

  1. Thanks for this great info … :)

  2. Thank you very much for sharing this info
    interesting as always

  3. Can I add multiple equipment in the one command?

    After adding all the custom resources with the set-resourceconfig command I then trigger this command:

    Set-Mailbox “$Alias” -ResourceCustom “$ResourceCustom”

    $ResourceCustom = a record in a CSV file containing all the different equipment separated by commas.

    When run I get the error “Projector,TV” is not valid.

  4. Hej,

    Thank you for great a post.

    Found out that this works when removing custom resource attributes:

    Set-Mailbox “Brisbane Lvl 1 Conference Room” -ResourceCustom @{Remove=”VideoConferencing”}

Leave a Comment

*

We are an Authorized DigiCert™ SSL Partner.