Set-ResourceConfig
Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3
Use the Set-ResourceConfig cmdlet to set resource property schema and resource locations on the Resource Config object in Active Directory.
Syntax
Set-ResourceConfig [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <ResourceBookingConfig>] [-ResourcePropertySchema <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]
Detailed Description
This command sets both the list of custom properties (resource property schema) and the internal list of locations on Resource Config object in Active Directory. All existing custom properties and locations will be overwritten when you use this command.
To run the Set-ResourceConfig cmdlet, 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 Exchange Server 2007, see Permission Considerations.
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name of the domain controller that retrieves data from Active Directory, include the DomainController parameter in the command. |
Instance |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ResourceBookingConfig |
The Instance parameter enables you to pass an entire object to the command to be processed. It is mainly used in scripts where an entire object must be passed to the command. |
ResourcePropertySchema |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
This parameter specifies a list of custom strings that you can use to tag resources. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
The Confirm parameter causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You do not have to specify a value with the Confirm parameter. |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf parameter. |
Input Types
Return Types
Errors
| Error | Description |
|---|---|
Exceptions
| Exceptions | Description |
|---|---|
Example
In this example, Equipment and Room resources are added to the custom Resource Config list in Active Directory.
Note
All entries must start with either Room/ or Equipment/. Setting a new entry using the Set-ResourceConfig cmdlet will overwrite all existing entries, and not add a new entry to the list. Use the Get-ResourceConfig cmdlet to query the existing entries, and then append to the list.
Set-ResourceConfig -DomainController server1.contoso.com -ResourcePropertySchema ("Room/16Seats","Equipment/Projector","Room/8Seats","Equipment/Whiteboard")