New-SettingOverride
Этот командлет доступен только в локальной среде Exchange.
Внимание! Неправильное использование командлетов переопределения параметров может нанести серьезный ущерб вашей организации Exchange. Это может потребовать переустановки Exchange. Используйте эти командлеты только в соответствии с документацией по продукту или под руководством Майкрософт обслуживания клиентов и поддержки.
Используйте командлет New-SettingOverride для создания переопределений параметров, которые хранят настройки Exchange в Active Directory, а не в текстовых файлах на сервере.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
New-SettingOverride
[-Name] <String>
-Component <String>
-Parameters <MultiValuedProperty>
-Reason <String>
-Section <String>
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-MaxVersion <Version>]
[-MinVersion <Version>]
[-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
New-SettingOverride -Name "IM Override" -Component OwaServer -Section IMSettings -Parameters @("IMServerName=skype01.contoso.com","IMCertificateThumbprint=CDF34A740E9D225A1A06193A9D44B2CE22775308") -Reason "Configure IM"В этом примере создается переопределение параметра с именем Интеграция сервера обмена мгновенными сообщениями. Это переопределение указывает пул Skype для бизнеса Server 2015 и отпечаток сертификата, который позволяет интегрировать мгновенные сообщения между Outlook в Интернете и Skype для бизнеса. Так как параметр Server не используется, переопределение применяется ко всем серверам Exchange 2016 в лесу Active Directory.
Дополнительные сведения см. в разделе Настройка интеграции обмена мгновенными сообщениями с Outlook в Интернете в Exchange 2016.
Пример 2
New-SettingOverride -Name "Change OAB Generation" -Server Mailbox01 -Component TimeBasedAssistants -Section OABGeneratorAssistant -Parameters @("WorkCycle=02:00:00") -Reason "Generate OAB Every 2 hours"В этом примере создается переопределение параметра с именем Change OAB Generation. Это переопределение задает 2-часовой интервал создания автономной адресной записи. Так как используется параметр Server, переопределение применяется только к указанному серверу с именем Mailbox01.
Дополнительные сведения см. в статье Изменение расписания создания автономной адресной книги в Exchange.
Параметры
-Component
Параметр Component задает компонент, к которому применяется переопределение параметра. Например:
- TimeBasedAssistants
- OwaServer
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 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 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.
Значение по умолчанию пусто ($null), что означает, что переопределение применяется ко всем версиям Exchange 2016.
| 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.
Значение по умолчанию пусто ($null), что означает, что переопределение применяется ко всем версиям Exchange 2016.
| 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 |
-Name
Параметр Name задает уникальное имя для переопределения параметра. Если значение содержит пробелы, его необходимо заключить в кавычки (").
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| 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: | True |
| 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: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Section
Параметр Section определяет имя раздела, для которого создается переопределение. Доступные значения для этого параметра зависят от значения параметра Component.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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.
| 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 |