How to Create or Remove Custom Resource Properties

Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.

 

Applies to: Exchange Server 2007, Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

This topic explains how to use the Exchange Management Shell to create or remove custom resource properties by modifying the resource configuration of your Exchange organization.

Note

You cannot use the Exchange Management Console to create or remove custom resource properties.

Custom resource properties are features for room or equipment mailboxes. Administrators can indicate that a resource has a specific feature by assigning the corresponding custom resource property to that resource mailbox.

Important

Custom resource properties cannot include spaces.

After you create the custom resource properties, you can assign them to a resource mailbox by using the resource mailbox properties in the Exchange Management Console or the Set-Mailbox cmdlet in the Exchange Management Shell. For detailed instructions about how to configure custom resource properties for a resource mailbox, see How to Configure Custom Resource Properties for a Resource Mailbox.

Before You Begin

To perform the following procedures, the account you use must be delegated the following:

  • Exchange Organization Administrator role

For more information about permissions, delegating roles, and the rights that are required to administer Microsoft Exchange Server 2007, see Permission Considerations.

Procedure

The following procedure creates three custom resource properties for room mailboxes and two custom resource properties for equipment mailboxes. The commands also demonstrate two methods for adding new custom resource properties. The syntax of both commands can be used interchangeably.

To use the Exchange Management Shell to create custom resource properties

  1. To read the current resource configuration and store it in a temporary variable called $ResourceConfiguration, run the following command:

    $ResourceConfiguration = Get-ResourceConfig
    
  2. To create the custom properties AV, TV, and Whiteboard for room mailboxes, run the following commands:

    Note

    This example assumes that some of the meeting rooms in your organization have audio-visual equipment, TV, or whiteboards. It also assumes that you want to differentiate the rooms that have the specified features from others that do not have these features.

    $ResourceConfiguration.ResourcePropertySchema+=("Room/AV")
    $ResourceConfiguration.ResourcePropertySchema.Add("Room/TV")
    $ResourceConfiguration.ResourcePropertySchema+=("Room/Whiteboard")
    
  3. To create the custom properties Car and Van for equipment mailboxes, run the following commands:

    Note

    This example assumes that your organization uses equipment mailboxes to track the scheduling of company vehicles, and you plan to use the custom resource properties to specify the vehicle type.

    $ResourceConfiguration.ResourcePropertySchema.Add("Equipment/Car")
    $ResourceConfiguration.ResourcePropertySchema+=("Equipment/Van")
    
  4. To update the resource configuration of your organization by using the modified resource property schema, run the following command:

    Set-ResourceConfig -Instance $ResourceConfiguration 
    

The following procedure removes two of the custom resource properties for room mailboxes that were created in the previous procedure. The commands also demonstrate two methods for removing a custom resource property. The syntax of both commands can be used interchangeably.

To use the Exchange Management Shell to remove custom resource properties

  1. To read the current resource configuration and store it in a temporary variable called $ResourceConfiguration, run the following command:

    $ResourceConfiguration = Get-ResourceConfig
    
  2. To remove the custom properties AV and TV for room mailboxes, run the following commands:

    $ResourceConfiguration.ResourcePropertySchema-=("Room/AV")
    $ResourceConfiguration.ResourcePropertySchema.Remove("Room/TV")
    
  3. To update the resource configuration of your organization by using the modified resource property schema, run the following command:

    Set-ResourceConfig -Instance $ResourceConfiguration
    

For detailed syntax and parameter information, see the Get-ResourceConfig and Set-ResourceConfig reference topics.

For More Information

For detailed instructions about how to add a resource custom property to a room or equipment mailbox, see How to Configure Custom Resource Properties for a Resource Mailbox.

For more information about managing resource scheduling, see Managing Resource Scheduling.

To learn more about resource mailboxes, see Understanding Recipients.