[This topic is in progress.]

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

Topic Last Modified: 2011-09-01

Use the Set-X400AuthoritativeDomain cmdlet to edit an existing 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

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

Detailed Description

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

  • A to Z

  • a to z

  • 0-9

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

You can use the following X.400 attributes (1 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

Identity

Required

Microsoft.Exchange.Configuration.Tasks.X400AuthoritativeDomainIdParameter

The Identity parameter specifies the display name of the X.400 authoritative domain.

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.

Name

Optional

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 must contain a maximum of 64 characters.

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.

X400DomainName

Optional

Microsoft.Exchange.Data.X400Domain

The X400DomainName parameter specifies the X.400 namespace that 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".

X400ExternalRelay

Optional

System.Boolean

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

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