Add-SecondaryDomain

[This is pre-release documentation and subject to change in future releases. This topic's current status is: Writing Not Started.]

Applies to: Exchange Server 2010 Beta Topic Last Modified: 2008-12-11

Use the Add-SecondaryDomain cmdlet to add an accepted domain for a tenant.


Add-SecondaryDomain -Name <String> -DomainName <SmtpDomain> -Organization <OrganizationIdParameter> [-Confirm [<SwitchParameter>]] [-DomainOwnershipVerified <SwitchParameter>] [-WhatIf [<SwitchParameter>]]


Add-SecondaryDomain [-Confirm [<SwitchParameter>]] [-IsDatacenter <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Parameter Required Type Description

Name

Required

System.String

The Name parameter specifies the friendly name of the accepted domain being added.

DomainName

Required

Microsoft.Exchange.Data.SmtpDomain

The DomainName parameter specifies the SMTP domain being added.

Organization

Required

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

The Organization parameter is reserved for internal Microsoft use.

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.

DomainOwnershipVerified

Optional

System.Management.Automation.SwitchParameter

The DomainOwnershipVerified parameter is reserved for internal Microsoft use.

IsDatacenter

Optional

System.Management.Automation.SwitchParameter

The IsDatacenter parameter is reserved for internal Microsoft use.

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.

To run this cmdlet, you must be assigned, either directly or using a universal security group, one of the following management roles:

  • Organization Management - Tenant

While all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they are not included in the management roles assigned to you. For more information, see Permissions Information for Cmdlet Help and Procedural Topics.

 

EXAMPLE 1

The following example adds the secondary domain sales.contoso.com using the friendly name "Sales Domain":

Add-SecondaryDomain -Name "Sales Domain" -DomainName sales.contoso.com
Show: