Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2007-06-28

Use the Set-X400AuthoritativeDomain cmdlet to edit an existing X.400 authoritative domain for the Microsoft Exchange Server 2007 organization. The X.400 authoritative domain defines the standard fields for the namespace that is appended to the recipient identity for all mailboxes that are assigned an X.400 address.

Syntax

Set-X400AuthoritativeDomain -Identity <X400AuthoritativeDomainIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-WhatIf [<SwitchParameter>]] [-X400DomainName <X400Domain>] [-X400ExternalRelay <$true | $false>]
Set-X400AuthoritativeDomain [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <X400AuthoritativeDomain>] [-Name <String>] [-WhatIf [<SwitchParameter>]] [-X400DomainName <X400Domain>] [-X400ExternalRelay <$true | $false>]

Parameters

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.X400AuthoritativeDomainIdParameter

Use this parameter to specify the display name of the X.400 authoritative domain.

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 don't have to specify a value with the Confirm parameter.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller that writes this configuration information from the Active Directory directory service, include the DomainController parameter on the command. The DomainController parameter is not supported on computers that have the Edge Transport server role installed. The Edge Transport server role writes and reads only to the local Active Directory Application Mode (ADAM) directory service.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.X400AuthoritativeDomain

Use this parameter to pass a whole object to the command to be processed. This parameter is mainly used in scripts where a whole object must be passed to the command.

Name

Optional

System.String

Use this parameter to create a unique name for an X.400 authoritative domain object. When you specify a name that includes spaces, you must enclose the whole name in quotation marks, for example, "Display Name". The Name parameter must contain 64 or fewer characters.

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.

X400DomainName

Optional

Microsoft.Exchange.Data.X400Domain

The X.400 namespace specified in the X400DomainName parameter can only include the X.400 organizational components. Specifically, only the following attribute types are supported:

  • Label (Abbreviation)

  • C (Country)

  • A (ADMD)

  • P (PRMD)

  • O (Organization)

  • OU1 (Organization unit 1)

  • OU2 (Organization unit 2)

  • OU3 (Organization unit 3)

  • OU4 (Organization unit 4)

The address attributes must be separated by semicolons and the address must be enclosed in quotation marks as follows, for example,

"C=US;A=att;P=Contoso;O=Example"

X400ExternalRelay

Optional

System.Boolean

Use this parameter to specify this authoritative domain as an external relay domain. If you set X400ExternalRelay to $true, Microsoft Exchange will route the e-mail to the external address and will not treat resolution failures to this sub-domain as an error.

Detailed Description

X.400 domain names can include only the following ASCII characters:

  • A to Z

  • a to z

  • 0-9

  • These punctuation and special characters: (space) ' () + , - . / : = ?

You can use the following X.400 attributes:

  • Name: country

    • Abbreviation: C

    • Maximum character length: 2

    • Maximum instance per address: 1

  • Name:  administrative domain

    • Abbreviation: A

    • Maximum character length: 16

    • Maximum instance per address: 1

  • Name:  private domain

    • Abbreviation: P

    • Maximum character length: 16

    • Maximum instance per address: 1

  • Name:  organization name

    • Abbreviation: O

    • Maximum character length: 64

    • Maximum instance per address: 1

  • Name: organizational unit name

    • Abbreviation: Ou1-4

    • Maximum character length: 32

    • Maximum instance per address: 1 each

To run the Set-X400AuthoritativeDomain cmdlet, the account you use must be delegated the following:

  • Exchange Server Administrator role and local Administrators group for the target server

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

Input Types

Return Types

Errors

Error Description

 

Example

The following code example makes the following changes to an existing X.400 authoritative domain:

  • It changes the domain name from "Sales" to "Sales and Marketing".

  • It updates the organizational attribute to "Sales and Marketing".

Copy Code
Set-X400AuthoritativeDomain Sales -X400DomainName "C=US;A=att,P=Contoso;O=Sales and Marketing"  -Name "Sales and Marketing"