New-EdgeSyncServiceConfig

Этот командлет доступен только в локальной среде Exchange.

Командлет New-EdgeSyncServiceConfig используется для задания параметров служб синхронизации пограничных серверов, чтобы контролировать поведение синхронизации, общее для всех служб EdgeSync.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

New-EdgeSyncServiceConfig
   [-ConfigurationSyncInterval <EnhancedTimeSpan>]
   [-Confirm]
   [-CookieValidDuration <EnhancedTimeSpan>]
   [-DomainController <Fqdn>]
   [-FailoverDCInterval <EnhancedTimeSpan>]
   [-LockDuration <EnhancedTimeSpan>]
   [-LockRenewalDuration <EnhancedTimeSpan>]
   [-LogEnabled <Boolean>]
   [-LogLevel <EdgeSyncLoggingLevel>]
   [-LogMaxAge <EnhancedTimeSpan>]
   [-LogMaxDirectorySize <Unlimited>]
   [-LogMaxFileSize <Unlimited>]
   [-LogPath <String>]
   [-OptionDuration <EnhancedTimeSpan>]
   [-RecipientSyncInterval <EnhancedTimeSpan>]
   [-Site <AdSiteIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

New-EdgeSyncServiceConfig -LogEnabled $true -LogPath "\\Server01\EdgeSyncLog" -LogMaxFileSize 5MB -LogMaxAge 3

В данном примере задаются параметры службы EdgeSync с помощью следующей конфигурации:

  • Ведение журнала EdgeSync включено.
  • Файлы журнала хранятся в общедоступном файле EdgeSyncLog на сервере Server01.
  • Максимальный размер файла отдельного журнала — 5 МБ.
  • Файлы журнала хранятся в течение 3 дней.

Параметры

-ConfigurationSyncInterval

Параметр ConfigurationSyncInterval указывает частоту синхронизации данных конфигурации службой EdgeSync. Значение по умолчанию — 3 минуты.

Чтобы указать значение, введите его в качестве интервала времени: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes and ss = seconds.

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-CookieValidDuration

Параметр CookieValidDuration указывает допустимый срок действия записи "cookie". Значение по умолчанию: 21 дня.

Чтобы указать значение, введите его в качестве интервала времени: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes and ss = seconds.

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-FailoverDCInterval

Параметр FailoverDCInterval указывает время ожидания EdgeSync перед отработкой отказа на другой контроллер домена, если ему не удается считывать данные конфигурации из Active Directory. Значение по умолчанию — 5 минут.

Чтобы указать значение, введите его в качестве интервала времени: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes and ss = seconds.

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LockDuration

Параметр LockDuration указывает продолжительность поддержания монопольной блокировки прав синхронизации экземпляром службы EdgeSync. Во время использования службой EdgeSync функции монопольной блокировки прав синхронизации никакая другая служба EdgeSync не может выполнять синхронизацию. Значение по умолчанию — 6 минут.

Чтобы указать значение, введите его в качестве интервала времени: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes and ss = seconds.

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LockRenewalDuration

Параметр LockRenewalDuration указывает продолжительность обновления монопольной блокировки службой EdgeSync до истечения срока ее действия. Значение по умолчанию — 4 минуты.

Чтобы указать значение, введите его в качестве интервала времени: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes and ss = seconds.

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LogEnabled

Параметр LogEnabled включает и отключает журнал EdgeSync. Для этого параметра допускаются значения $true и $false. Значение по умолчанию — $true.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LogLevel

Параметр LogLevel указывает уровень детализации ведения журнала EdgeSync. Допустимые значения:

  • Нет (это значение по умолчанию)
  • Низкая
  • Средняя
  • Высокая
Type:EdgeSyncLoggingLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LogMaxAge

Параметр LogMaxAge задает максимальную продолжительность хранения файлов EdgeSyncLog, выраженную в днях. Файлы журнала, хранящиеся дольше указанного значения, будут перезаписаны. Значение по умолчанию — 30 дней.

Чтобы указать значение, введите его в качестве интервала времени: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes and ss = seconds.

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LogMaxDirectorySize

Параметр LogMaxDirectorySize указывает максимальный размер дискового пространства, которое может использоваться для каталога EdgeSyncLog. Значение по умолчанию — 250 МБ.

Допустимое значение — число до 1,999999999 ТБ (2 199 023 254 528 Б) или значение unlimited. Значение по умолчанию — 6 ГБ (6 442 450 944 Б).

  • Б (байт)
  • КБ (килобайт)
  • МБ (мегабайт)
  • ГБ (гигабайты)
  • ТБ (терабайт)

TB (терабайт)

Значение параметра LogMaxFileSize должно быть меньше или равно значению, указанному в параметре LogMaxDirectorySize. Допустимый диапазон вводимых значений для любого из этих параметров — от 1 до 9 223 372 036 854 775 807 байт. Если ввести значение unlimited, никакие ограничения на размер каталога EdgeSyncLLog налагаться не будут.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LogMaxFileSize

Параметр LogMaxFileSize указывает максимальный размер файла журнала для файлов EdgeSyncLog. Значение по умолчанию — 10 МБ.

Допустимое значение — число до 1,999999999 ТБ (2 199 023 254 528 Б) или значение unlimited. Значение по умолчанию — 6 ГБ (6 442 450 944 Б).

  • Б (байт)
  • КБ (килобайт)
  • МБ (мегабайт)
  • ГБ (гигабайты)
  • ТБ (терабайт)

TB (терабайт)

Значение параметра LogMaxFileSize должно быть меньше или равно значению, указанному в параметре LogMaxDirectorySize. Допустимый диапазон вводимых значений для любого из этих параметров — от 1 до 9 223 372 036 854 775 807 байт. Если ввести значение unlimited, никакие ограничения на размер файлов EdgeSyncLog налагаться не будут.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LogPath

Параметр LogPath указывает местоположение файлов EdgeSyncLog по умолчанию. По умолчанию значение равно TransportRoles\Logs\EdgeSync\.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-OptionDuration

Параметр OptionDuration указывает продолжительность поддержания дополнительной блокировки прав синхронизации экземпляром службы EdgeSync. Во время использования службой EdgeSync функции дополнительной блокировки прав синхронизации другая служба EdgeSync может выполнять синхронизацию после окончания действия дополнительной блокировки, если она установлена с помощью команды Start-EdgeSynchronization. Значение по умолчанию — 30 минут.

Чтобы указать значение, введите его в качестве интервала времени: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes and ss = seconds.

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RecipientSyncInterval

Параметр RecipientSyncInterval указывает частоту синхронизации данных получателя из глобального каталога службой EdgeSync. Значение по умолчанию — 5 минут.

Чтобы указать значение, введите его в качестве интервала времени: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes and ss = seconds.

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Site

Параметр Site указывает сайт Active Directory, к которому подключается EdgeSync для синхронизации данных конфигурации и получателя.

Type:AdSiteIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.