Set-SettingOverride

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

Внимание! Неправильное использование командлетов переопределения параметров может нанести серьезный ущерб вашей организации Exchange. Это может потребовать переустановки Exchange. Используйте эти командлеты только в соответствии с документацией по продукту или под руководством Майкрософт обслуживания клиентов и поддержки.

Используйте командлет Set-SettingOverride для изменения переопределений параметров, которые хранят настройки Exchange в Active Directory, а не в текстовых файлах на сервере.

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

Синтаксис

Set-SettingOverride
   [-Identity] <SettingOverrideIdParameter>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-MaxVersion <Version>]
   [-MinVersion <Version>]
   [-Parameters <MultiValuedProperty>]
   [-Reason <String>]
   [-Server <String[]>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Параметры переопределяют настройку и хранение настроек Exchange Server в Active Directory. Параметры могут быть для всей организации или сервера, и они сохраняются в Active Directory в рамках накопительных Обновления (CU) Exchange. Настройки Exchange в файлах конфигурации приложений web.config или exe.config XML зависят от сервера и теряются при установке следующего накопительного пакета обновления Exchange.

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

Примеры

Пример 1

Set-SettingOverride -Identity "Change OAB Generation" -Server Mailbox01 -Parameters @("WorkCycle=03:00:00")

В этом примере изменяется переопределение параметра с именем Change OAB Generation на сервере Mailbox01 путем изменения интервала создания OAB на 3 часа.

Параметры

-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 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 2013, Exchange Server 2016, Exchange Server 2019

-Force

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

Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.

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

-Identity

Параметр Identity задает переопределение параметра, которое необходимо изменить. Можно использовать любое значение, уникально идентифицирующее данное переопределение. Например:

  • имя;
  • различающееся имя (DN);
  • GUID
Type:SettingOverrideIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MaxVersion

Параметр MaxVersion указывает последнюю версию Exchange 2016, к которому применяется это переопределение (до и с учетом указанного значения).

Допустимые входные данные для этого параметра — это значение версии Exchange 2016 в формате 15.1.xxx.xx. Можно использовать значения, которые начинаются с нулей, но нули будут удалены из результатов. Например, 15.01.0225.042 хранится в виде 15.1.225.42.

Чтобы удалить настроенное значение версии, чтобы переопределение применялось ко всем версиям Exchange 2016, используйте значение $null.

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

-MinVersion

Параметр MinVersion указывает самую раннюю версию Exchange 2016, к которому применяется это переопределение (до и с учетом указанного значения).

Допустимые входные данные для этого параметра — это значение версии Exchange 2016 в формате 15.1.xxx.xx. Можно использовать значения, которые начинаются с нулей, но нули будут удалены из результатов. Например, 15.01.0225.042 хранится в виде 15.1.225.42.

Чтобы удалить настроенное значение версии, чтобы переопределение применялось ко всем версиям Exchange 2016, используйте значение $null.

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

-Parameters

Параметр Parameters задает один или несколько параметров для переопределения, доступного для комбинации значений параметров Component и Section. Этот параметр использует синтаксис: @("Parameter1=Value1","Parameter2=Value2"...). Например:

  • @("Enabled=true")
  • @("IMServerName=<SkypePoolFQDN>","IMCertificateThumbprint=<ThumbprintGUID>")
Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Reason

Параметр Reason используется, чтобы указать причину создания переопределения. Если значение содержит пробелы, его необходимо заключить в кавычки (").

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

-Server

Параметр Server указывает имя сервера Exchange 2016, на который требуется применить переопределение. Можно указать одно имя сервера Exchange 2016 или массив подстановочных знаков имен сервера Exchange 2016. Например, если у вас есть три сервера Exchange 2016 с именами Exchange01, Exchange02 и Exchange03, укажите значение Exchange* для применения переопределения ко всем из них.

Чтобы удалить указанный сервер, чтобы переопределение применялось ко всем серверам Exchange 2016 в лесу Active Directory, используйте значение $null.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 2013, Exchange Server 2016, Exchange Server 2019