[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>]]

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