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:
The address attributes must be separated by semicolons and the address must be enclosed in quotation marks as follows, for example,
|
X400ExternalRelay |
Optional |
System.Boolean |
Use this parameter to specify this authoritative domain as an
external relay domain. If you set X400ExternalRelay to
|
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
- Abbreviation: C
- Name: administrative domain
- Abbreviation: A
- Maximum character length: 16
- Maximum instance per address: 1
- Abbreviation: A
- Name: private domain
- Abbreviation: P
- Maximum character length: 16
- Maximum instance per address: 1
- Abbreviation: P
- Name: organization name
- Abbreviation: O
- Maximum character length: 64
- Maximum instance per address: 1
- Abbreviation: O
- Name: organizational unit name
- Abbreviation: Ou1-4
- Maximum character length: 32
- Maximum instance per address: 1 each
- Abbreviation: Ou1-4
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" |