Export-AutoDiscoverConfig

  • Article

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

The Export-AutoDiscoverConfig cmdlet lets you create or update a Service Connection Point (SCP) for an Autodiscover service pointer in a target Exchange forest on a Microsoft Exchange Server 2007 computer that has the Client Access server role installed.

Syntax

Export-AutoDiscoverConfig -TargetForestDomainController <String> [-Confirm [<SwitchParameter>]] [-DeleteConfig <Nullable>] [-DomainController <Fqdn>] [-MultipleExchangeDeployments <$true | $false>] [-PreferredSourceFqdn <Fqdn>] [-SourceForestCredential <PSCredential>] [-TargetForestCredential <PSCredential>] [-WhatIf [<SwitchParameter>]]

Detailed Description

The Export-AutoDiscoverConfig cmdlet lets you create or update an Autodiscover Service Connection Point (SCP) pointer in a target Exchange forest on an Exchange 2007 Client Access server. The Autodiscover SCP pointer resides in the Active Directory directory service and contains the names of the Exchange Web service URLs.

To run the Export-AutoDiscoverConfig cmdlet, the account you use must be delegated the Exchange Server Administrator role and membership in the 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.

Parameters

Parameter Required Type Description

TargetForestDomainController

Required

System.String

This parameter specifies the domain controller that you want to export the Autodiscover configuration to.

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm parameter causes the command to pause processing and requires that you acknowledge what the command will do before processing continues. You do not have to specify a value with the Confirm parameter.

DeleteConfig

Optional

System.Nullable

This parameter causes the command to delete your configuration settings on the Service Connection Point object.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller to the Active Directory directory service, include the DomainController parameter on the cmdlet.

MultipleExchangeDeployments

Optional

System.Boolean

This parameter specifies whether multiple Exchange deployments exist. This setting should be set to $true only if Exchange 2007 is deployed in more than one Active Directory forest and the forests are connected. If set to $true, the list of Authoritative Accepted Domains for the source forest is written to the Autodiscover SCP object. Microsoft Office Outlook 2007 clients will use this object to select the most appropriate forest to search for the Autodiscover service.

PreferredSourceFqdn

Optional

Microsoft.Exchange.Data.Fqdn

This parameter specifies the fully qualified domain name (FQDN) of the Active Directory domain for the Autodiscover pointer SCP object.

SourceForestCredential

Optional

System.Management.Automation.PSCredential

This parameter specifies the credentials to use when connecting to the source forest.

TargetForestCredential

Optional

System.Management.Automation.PSCredential

This parameter specifies the credentials to use to connect to the target forest.

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 do not have to specify a value with the WhatIf parameter.

Input Types

Return Types

Errors

Error Description

 

 

Exceptions

Exceptions Description

 

 

Example

This code example creates an SCP object to another Active Directory forest so that Outlook 2007 clients can automatically connect to their mailbox without having to set up a profile.

Export-AutoDiscoverConfig -TargetForestDomainController targetDomainControllerName [-TargetForestCredential <credentials>] [-SourceForestCredential <credentials>][-MultipleExchangeDeployments:$true] [-DomainController DC01]