[This topic is in progress.]

Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

Topic Last Modified: 2011-05-07

Use the Set-EdgeSyncServiceConfig cmdlet to modify the configuration of edge synchronization service settings that control the general synchronization behavior shared by all EdgeSync services.

Syntax

Set-EdgeSyncServiceConfig -Identity <EdgeSyncServiceConfigIdParameter> [-ConfigurationSyncInterval <EnhancedTimeSpan>] [-Confirm [<SwitchParameter>]] [-CookieValidDuration <EnhancedTimeSpan>] [-DomainController <Fqdn>] [-FailoverDCInterval <EnhancedTimeSpan>] [-LockDuration <EnhancedTimeSpan>] [-LockRenewalDuration <EnhancedTimeSpan>] [-LogEnabled <$true | $false>] [-LogLevel <None | Low | Medium | High>] [-LogMaxAge <EnhancedTimeSpan>] [-LogMaxDirectorySize <Unlimited>] [-LogMaxFileSize <Unlimited>] [-LogPath <String>] [-Name <String>] [-OptionDuration <EnhancedTimeSpan>] [-RecipientSyncInterval <EnhancedTimeSpan>] [-WhatIf [<SwitchParameter>]]

Detailed Description

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "EdgeSync" entry in the Transport Permissions topic.

Parameters

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.EdgeSyncServiceConfigIdParameter

The Identity parameter specifies the name of the Microsoft Exchange EdgeSync service you want to configure.

ConfigurationSyncInterval

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

The ConfigurationSyncInterval parameter specifies how frequently the Microsoft Exchange EdgeSync service synchronizes configuration data.

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.

CookieValidDuration

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

The CookieValidDuration parameter specifies how long a cookie record is valid.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory.

FailoverDCInterval

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

The FailoverDCInterval parameter specifies how long EdgeSync waits before failing over to another domain controller if it can't read configuration data from Active Directory.

LockDuration

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

The LockDuration parameter specifies how long an instance of the Microsoft Exchange EdgeSync service can maintain an exclusive lock on the synchronization rights. While an EdgeSync service maintains an exclusive lock on synchronization rights, no other EdgeSync service can take over synchronization.

LockRenewalDuration

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

The LockRenewalDuration parameter specifies how long before the expiry of an exclusive lock an EdgeSync service can renew the lock.

LogEnabled

Optional

System.Boolean

The LogEnabled parameter specifies whether EdgeSyncLog is enabled.

LogLevel

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.EdgeSyncLoggingLevel

The LogLevel parameter specifies the logging level used.

LogMaxAge

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

The LogMaxAge parameter specifies the maximum duration in days to keep EdgeSyncLog before it can be overwritten.

LogMaxDirectorySize

Optional

Microsoft.Exchange.Data.Unlimited

The LogMaxDirectorySize specifies the cap on the amount of disk space the EdgeSyncLog directory can use.

LogMaxFileSize

Optional

Microsoft.Exchange.Data.Unlimited

The LogMaxFileSize parameter specifies the maximum log file size for the EdgeSyncLog files.

LogPath

Optional

System.String

The LogPath parameter specifies the disk location to store the EdgeSyncLog files.

Name

Optional

System.String

The Name parameter specifies the specific name for the Microsoft Exchange EdgeSync service configuration.

OptionDuration

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

The OptionDuration parameter specifies how long an instance of the Microsoft Exchange EdgeSync service can maintain an optional lock on the synchronization rights. While an EdgeSync service maintains an optional lock on synchronization rights, another EdgeSync service can take over synchronization after the optional lock has expired if it's initiated using the Start-EdgeSynchronization command.

RecipientSyncInterval

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

The RecipientSyncInterval parameter specifies how frequently the Microsoft Exchange EdgeSync service synchronizes recipient data from the global catalog.

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.

Input Types

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

Return Types

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.

Examples

EXAMPLE 1

This example configures the Microsoft Exchange EdgeSync service settings Primary EdgeSync Settings with the following configuration:

  • EdgeSync logging is enabled.

  • The log files are stored in the EdgeSyncLog share on Server01.

  • The maximum individual log file size is 5 megabytes (MB).

  • The log files are kept for 3 days.

Copy Code
Set-EdgeSyncServiceConfig "Primary EdgeSync Settings" -LogEnabled $true -LogPath "\\Server01\EdgeSyncLog" -LogMaxFileSize 5MB -LogMaxAge 3