Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3
Use the New-AcceptedDomain cmdlet to create a new accepted ___domain in your organization. An accepted ___domain is any Simple Mail Transfer Protocol (SMTP) namespace for which an Exchange organization sends and receives e-mail. Accepted domains include those domains for which the Exchange organization is authoritative. An Exchange organization is authoritative when it handles mail delivery for recipients in the accepted ___domain. Accepted domains also include domains for which the Exchange organization receives mail and then relays to an e-mail server that is outside the Active Directory forest for delivery to the recipient.
For more information about how to configure an accepted ___domain, see Set-AcceptedDomain.
Syntax
New-AcceptedDomain -Name <String> -DomainName <SmtpDomainWithSubdomains> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DomainType <Authoritative | ExternalRelay | InternalRelay>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]
Detailed Description
To run the New-AcceptedDomain 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 Microsoft Exchange Server 2007, see Permission Considerations.
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
DomainName |
Required |
Microsoft.Exchange.Data.SmtpDomainWithSubdomains |
Valid input for the DomainName parameter is an SMTP ___domain. Enter the SMTP ___domain that you want to establish as an accepted ___domain. You can use a wildcard character to specify all subdomains of a given ___domain, as shown in the following example: However, you cannot embed a wildcard character, as shown in the following example: The ___domain name string may not contain more than 256 characters, including the period that separates each level of the ___domain name. For example, a ___domain name that has a three-character top-level ___domain could contain 63 characters for each of the other levels: 63Characters.63Characters.63Characters.63Characters.com. In this example, the 63 characters for four levels, plus the four periods, plus the three letters of the top-level ___domain name "com" equals a total of 256 characters. |
Name |
Required |
System.String |
Use this parameter to create a unique name for the accepted ___domain object. |
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 Active Directory Application Mode (ADAM) instance. |
DomainType |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.AcceptedDomainType |
Use this parameter to set the type of accepted ___domain that you want to configure. Valid values are In an authoritative ___domain, messages are delivered to a recipient that has a ___domain account in your Exchange organization. In an internal relay ___domain, messages are relayed to a server that is outside your Exchange organization, but still under the authority of your company or IT department. Use the internal relay ___domain if you want to treat the messages to this ___domain as internal messages. In an external relay ___domain, messages are relayed to an e-mail server, outside your organization, which you do not control. The default value is |
TemplateInstance |
Optional |
System.Management.Automation.PSObject |
When an existing object is supplied to the TemplateInstance parameter, the command uses the configuration of the existing object to create an identical copy 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. |
Example
The following code example creates a new accepted ___domain that is named Contoso. For more information about how to set additional configuration options on the accepted ___domain object, see Set-AcceptedDomain.
New-AcceptedDomain -DomainName Contoso.com -Name Contoso