Share via


Create or Remove Custom Resource Properties

Applies to: Exchange Server 2010

You can use the Shell to create or remove custom resource properties by modifying the resource configuration of your Exchange organization.

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

Important

Custom resource properties can't include spaces.

Looking for other management tasks related to resource mailboxes? Check out Managing Resource Mailboxes and Scheduling.

Use the Shell to add custom resource properties to the resource schema

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Recipient Provisioning Permissions" section in the Mailbox Permissions topic.

Note

You can't use the EMC to add custom resource properties to the resource schema.

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

  1. Use the following command to read the current resource configuration and store it in a temporary variable called $ResourceConfiguration.

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

    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 don't.

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

    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. Use the following commands to update the resource configuration of your organization by using the modified resource property schema.

    Set-ResourceConfig -ResourcePropertySchema $ResourceConfiguration.ResourcePropertySchema
    

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

Use the Shell to remove custom resource properties from the resource schema

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Recipient Provisioning Permissions" section in the Mailbox Permissions topic.

This example 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.

  1. Use the following command to read the current resource configuration and store it in a temporary variable called $ResourceConfiguration.

    $ResourceConfiguration = Get-ResourceConfig
    
  2. Use the following commands to remove the custom properties AV and TV from room mailboxes.

    $ResourceConfiguration.ResourcePropertySchema-=("Room/AV")
    $ResourceConfiguration.ResourcePropertySchema.Remove("Room/TV")
    
  3. Use the following commands to update the resource configuration of your organization by using the modified resource property schema.

    Set-ResourceConfig -ResourcePropertySchema $ResourceConfiguration.ResourcePropertySchema
    

For detailed syntax and parameter information, see Get-ResourceConfig and Set-ResourceConfig

Other Tasks

After you create custom resource properties, you may also want to assign them to a resource mailbox. For detailed steps, see Configure Custom Resource Properties for a Resource Mailbox.