Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2009-05-15

Use the Set-OrganizationConfig cmdlet to configure various settings of an Exchange organization.


Set-OrganizationConfig [-AlwaysQuoteDisplayName <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ManagedFolderHomepage <String>] [-MicrosoftExchangeRecipientEmailAddresses <ProxyAddressCollection>] [-MicrosoftExchangeRecipientEmailAddressPolicyEnabled <$true | $false>] [-MicrosoftExchangeRecipientPrimarySmtpAddress <SmtpAddress>] [-MicrosoftExchangeRecipientReplyRecipient <RecipientIdParameter>] [-SCLJunkThreshold <Int32>] [-ShowInlineAttachments <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Set-OrganizationConfig [-AlwaysQuoteDisplayName <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <Organization>] [-ManagedFolderHomepage <String>] [-MicrosoftExchangeRecipientEmailAddresses <ProxyAddressCollection>] [-MicrosoftExchangeRecipientEmailAddressPolicyEnabled <$true | $false>] [-MicrosoftExchangeRecipientPrimarySmtpAddress <SmtpAddress>] [-MicrosoftExchangeRecipientReplyRecipient <RecipientIdParameter>] [-SCLJunkThreshold <Int32>] [-ShowInlineAttachments <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]


Parameter Required Type Description




The AlwaysQuoteDisplayName parameter causes RFC822 display names to be enclosed in quotation marks before a message is encoded for clients that do not conform to RFC standards.




The Confirm parameter causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm parameter.




To specify the fully qualified domain name (FQDN) of the domain controller that retrieves this configuration information from the Active Directory directory service, include the DomainController parameter in the command.




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.




The ManagedFolderHomepage parameter specifies the URL of the Web page that is displayed when users click the Managed Folders folder in Microsoft Outlook. If a URL is not specified, Outlook does not display a managed folders home page.




The MicrosoftExchangeRecipientEmailAddresses parameter specifies one or more e-mail addresses for the Microsoft Exchange recipient. All valid Exchange 2007 e-mail address types may be used. You can specify multiple values for this parameter as a comma-delimited list. If the MicrosoftExchangeRecipientEmailAddressPolicyEnabled parameter is set to $True, the e-mail addresses are automatically generated by the default e-mail address policy. This means you cannot use the MicrosoftExchangeRecipientEmailAddresses parameter.

E-mail addresses that you specify by using the MicrosoftExchangeRecipientEmailAddresses parameter replace any existing e-mail addresses that are already configured.




The MicrosoftExchangeRecipientEmailAddressPolicyEnabled parameter specifies whether the default e-mail address policy is automatically applied to the Microsoft Exchange recipient. The default value is $True. If this parameter is set to $True, Exchange 2007 automatically adds new e-mail addresses to the Microsoft Exchange recipient when e-mail address policies are added or modified in the Exchange organization. If this parameter is set to $False, you must manually add new e-mail address to the Microsoft Exchange recipient when e-mail address policies are added or modified.

If you change the value of the MicrosoftExchangeRecipientEmailAddressPolicyEnabled parameter from $False to $True, any e-mail addresses that you defined by using the MicrosoftExchangeRecipientRecipientEmailAddresses parameter are preserved. However, the value of the MicrosoftExchangeRecipientPrimarySmtpAddress parameter reverts to MicrosoftExchange329e71ec88ae4615bbc36ab6ce41109e@<Accepted Domain in Highest Priority E-mail Address Policy>.




The MicrosoftExchangeRecipientPrimarySmtpAddress parameter specifies the primary return SMTP e-mail address for the Microsoft Exchange recipient. If the MicrosoftExchangeRecipientEmailAddressPolicyEnabled parameter is set to $True, you can't use the MicrosoftExchangeRecipientPrimarySmtpAddress parameter.

If you modify the value of the MicrosoftExchangeRecipientPrimarySmtpAddress parameter, the value is automatically added to the list of e-mail addresses that are defined in the MicrosoftExchangeRecipientRecipientEmailAddresses parameter.

The MicrosoftExchangeRecipientPrimarySmtpAddress parameter is meaningful only if the Microsoft Exchange recipient has more than one defined SMTP e-mail addresses. If the MicrosoftExchangeRecipientRecipientEmailAddresses parameter has only one defined SMTP e-mail address, the value of the MicrosoftExchangeRecipientPrimarySmtpAddress parameter and the MicrosoftExchangeRecipientRecipientEmailAddresses parameter are the same.




The MicrosoftExchangeRecipientReplyRecipient parameter specifies the recipient that should receive messages that are sent to the Microsoft Exchange recipient. Typically, you would configure a mailbox to receive the messages that are sent to the Microsoft Exchange recipient. This parameter can take any of the following values for the specified recipient:

  • Distinguished name (DN)

  • Canonical name

  • GUID

  • Name

  • Display name

  • Alias

  • Exchange DN

  • Primary SMTP e-mail address

If you don't configure a recipient for the Microsoft Exchange recipient, messages that are sent to the Microsoft Exchange recipient are discarded.




The SCLJunkThreshold parameter specifies the spam confidence level (SCL) threshold. Messages with an SCL greater than the value that you specify for the SCLJunkThreshold parameter are moved to the Junk E-mail folder. Valid values are integers from 0 through 9, inclusive.




The ShowInlineAttachments parameter causes the inbound conversion of messages so that they show inline attachments in the attachment well. This conversion is for clients that set an inline type but that do not reference the content.




This parameter is available only in Exchange 2007 SP2.

The UseRusServer parameter instructs the command to use the specified Mailbox server on which the Address List service is running to obtain and then set mailbox and Active Directory user attributes.

The Address List service is a component in the Exchange System Attendant service. The Address List service creates and maintains Exchange-specific attribute values in Active Directory. You can use the Address List service to update recipient objects in a domain by using specific information, such as address list membership and e-mail addresses.




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.

Detailed Description

To run the Set-OrganizationConfig 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 Microsoft Exchange Server 2007, see Permission Considerations.

Input Types

Return Types


Error Description


Exceptions Description


This example shows how to use the Set-OrganizationConfig command to specify the URL of the organization's managed folders home page. The managed folders home page is displayed when users click the Managed Folders folder in Outlook. It enables users to view the managed folders in their mailbox and to add or delete them.

Copy Code
Set-OrganizationConfig -ManagedFolderHomepage "http://contoso/managedfolderhomepage.htm"