[This topic is in progress.]

Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

Topic Last Modified: 2011-09-01

Use the New-X400AuthoritativeDomain cmdlet to create and specify the X.400 authoritative domain for the Microsoft Exchange Server 2010 organization. The X.400 authoritative domain defines the standard fields for the namespace appended to the recipient identity for all mailboxes assigned an X.400 address.

Syntax

New-X400AuthoritativeDomain -Name <String> -X400DomainName <X400Domain> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-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 (one each per address):

  • Name   country   Abbreviation   C   Maximum character length   2

  • Name   administrative domain   Abbreviation   A   Maximum character length   16

  • Name   private domain   Abbreviation   P   Maximum character length   16

  • Name   organization name   Abbreviation   O   Maximum character length   64

  • Name   organizational unit name   Abbreviation   Ou1-4   Maximum character length   32

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "X.400 domains" entry in the Transport Permissions topic.

Parameters

Parameter Required Type Description

Name

Required

System.String

The Name parameter specifies a unique name for an X.400 authoritative domain object. When you specify a name that includes spaces, you must enclose the name in quotation marks ("), for example, "Display Name". The Name parameter can't exceed 64 characters.

X400DomainName

Required

Microsoft.Exchange.Data.X400Domain

The X400DomainName parameter specifies the X.400 namespace, which 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=Sales"

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm switch 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 switch.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory. The DomainController parameter isn't supported on the Edge Transport server role. The Edge Transport server role writes only to the Active Directory Lightweight Directory Services (AD LDS) instance.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, 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 switch.

X400ExternalRelay

Optional

System.Boolean

The X400ExternalRelay parameter specifies this authoritative domain as an external relay domain. If you set the X400ExternalRelay parameter to $true, Microsoft Exchange routes e-mail to the external address and doesn't treat resolution failures to this subdomain as an error.

Input Types

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

Return Types

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.

Examples

EXAMPLE 1

This example creates the X.400 authoritative domain Sales in the private domain Contoso, which is under the administrative domain Fabrikam.

Copy Code 
New-X400AuthoritativeDomain -Name Sales -X400DomainName "C=US;A=Fabrikam;P=Contoso;O=Sales"

EXAMPLE 2

This example creates an external relay domain for the X.400 namespace Europe organizational unit (OU) under the Sales organization in the private domain Contoso, which is under the administrative domain Fabrikam.

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