New-X400AuthoritativeDomain

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

Use the New-X400AuthoritativeDomain cmdlet to create and specify the 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

New-X400AuthoritativeDomain -Name <String> -X400DomainName <X400Domain> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]] [-X400ExternalRelay <$true | $false>]

Detailed Description

X.400 domain names can only include 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 New-X400AuthoritativeDomain 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 2007, see Permission Considerations.

Parameters

Parameter Required Type Description

Name

Required

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.

X400DomainName

Required

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, for example,

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

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.

TemplateInstance

Optional

System.Management.Automation.PSObject

When an existing object is supplied to this parameter, the command uses the configuration of that object to create a duplicate of the object on a local or target server.

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.

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.

Input Types

Return Types

Errors

Error Description

 

Example

The first example shows how to create a new X.400 authoritative domain that is named "Sales".

The second example shows how to create an external relay domain for a X.400 namespace that is named "Sales Europe".

New-X400AuthoritativeDomain -Name Sales -X400DomainName "C=US;A=att;P=Contoso;O=Sales"
New-X400AuthoritativeDomain -Name "Sales Europe" -X400DomainName "C=US;A=att;P=Contoso;O=Sales;OU1=Europe" -X400ExternalRelay: $true