Share via


Set-OrganizationConfig (RTM)

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

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

Syntax

Set-OrganizationConfig [-DomainController <Fqdn>] [-ManagedFolderHomepage <String>] [-MicrosoftExchangeRecipientEmailAddresses <ProxyAddressCollection>] [-MicrosoftExchangeRecipientEmailAddressPolicyEnabled <$true | $false>] [-MicrosoftExchangeRecipientPrimarySmtpAddress <SmtpAddress>] [-MicrosoftExchangeRecipientReplyRecipient <RecipientIdParameter>] [-SCLJunkThreshold <Int32>]

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

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.

Parameters

Parameter Required Type Description

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

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.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.Organization

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.

ManagedFolderHomepage

Optional

System.String

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.

MicrosoftExchangeRecipientEmailAddresses

Optional

Microsoft.Exchange.Data.ProxyAddressCollection

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.

MicrosoftExchangeRecipientEmailAddressPolicyEnabled

Optional

System.Boolean

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

MicrosoftExchangeRecipientPrimarySmtpAddress

Optional

Microsoft.Exchange.Data.SmtpAddress

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.

MicrosoftExchangeRecipientReplyRecipient

Optional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

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.

SCLJunkThreshold

Optional

System.Int32

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 will be moved to the Junk E-mail folder. Valid values are integers from 0 through 9, inclusive.

Input Types

Return Types

Errors

Error Description

Exceptions

Exceptions Description

Example

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.

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