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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.