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: *.contoso.com.

However, you cannot embed a wildcard character, as shown in the following example: domain.*.contoso.com.

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 Authoritative, InternalRelay, ExternalRelay. You must set at least one value.

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 Authoritative.

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.