Set-ExchangeSettings

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

Используйте командлет Set-ExchangeSettings для настройки объектов параметров Exchange, созданных с помощью командлета New-ExchangeSettings.

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

Синтаксис

ClearHistory

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-ClearHistory]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

UpdateSetting

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ConfigName <String>
    -ConfigValue <String>
    -Reason <String>
    [-UpdateSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-WhatIf]
    [<CommonParameters>]

RemoveSetting

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ConfigName <String>
    -Reason <String>
    [-RemoveSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ExpirationDate <DateTime>
    -Reason <String>
    [-ConfigPairs <String[]>]
    [-Confirm]
    [-CreateSettingsGroup]
    [-Disable]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-MaxVersion <String>]
    [-MinVersion <String>]
    [-NameMatch <String>]
    [-Priority <Int32>]
    [-Scope <ExchangeSettingsScope>]
    [-ScopeFilter <String>]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroupGuid

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ExpirationDate <DateTime>
    -GuidMatch <Guid>
    -Reason <String>
    [-ConfigPairs <String[]>]
    [-Confirm]
    [-CreateSettingsGroup]
    [-Disable]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-Priority <Int32>]
    [-Scope <ExchangeSettingsScope>]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroupAdvanced

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -SettingsGroup <String>
    [-CreateSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroupGeneric

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ExpirationDate <DateTime>
    -Reason <String>
    [-CreateSettingsGroup]
    [-ConfigPairs <String[]>]
    [-GenericScopeName <String>]
    [-GenericScopeValue <String>]
    [-GroupName <String>]
    [-Confirm]
    [-Disable]
    [-DomainController <Fqdn>]
    [-Force]
    [-Priority <Int32>]
    [-Scope <ExchangeSettingsScope>]
    [-WhatIf]
    [<CommonParameters>]

UpdateSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-ExpirationDate <DateTime>]
    [-GroupName <String>]
    [-UpdateSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-Priority <Int32>]
    [-ScopeFilter <String>]
    [-WhatIf]
    [<CommonParameters>]

RemoveMultipleSettings

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -ConfigPairs <String[]>
    [-GroupName <String>]
    [-RemoveSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

RemoveSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-GroupName <String>]
    [-RemoveSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

UpdateSettingsGroupAdvanced

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -SettingsGroup <String>
    [-UpdateSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

UpdateMultipleSettings

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -ConfigPairs <String[]>
    [-GroupName <String>]
    [-UpdateSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

EnableSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-EnableGroup <String>]
    [-DisableGroup <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

Описание

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

Примеры

Пример 1

Set-ExchangeSettings Audit -UpdateSetting -ConfigName AuditLogPumperEnabled -ConfigValue $true -Reason "Enable Unified Audit Logging"

В этом примере показано, как разрешить пользователям просматривать результаты ведения журнала единого аудита. В этом примере предполагается, что вы уже создали объект параметров Exchange для схемы аудита конфигурации, выполнив команду New-ExchangeSettings -Name Audit.

Параметры

-ClearHistory

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Ключ ClearHistory определяет, что вы хотите очистить записи в журнале изменений для объекта настройки Exchange. С этим параметром не нужно указывать значение.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ClearHistory
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ConfigName

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр ConfigName указывает доступный параметр Exchange, который нужно добавить, удалить или обновить в объекте параметров Exchange. Допустимые значения этого параметра определяет схема конфигурации, указанная параметром Name командлета New-ExchangeSettings.

Для операций добавления и обновления также необходимо указать фактическое значение параметра с помощью параметра ConfigValue. Параметр ConfigName невозможно использовать вместе с параметром ConfigPairs.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateSetting
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
RemoveSetting
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ConfigPairs

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр ConfigName указывает доступный параметр Exchange, который нужно добавить, удалить или обновить в объекте параметров Exchange. Допустимые значения этого параметра определяет схема конфигурации, указанная параметром Name командлета New-ExchangeSettings. Синтаксис значения имеет следующий вид: <Key>=<Value>. Можно указать несколько значений, разделенных запятыми.

Параметр ConfigPairs невозможно использовать вместе с параметрами ConfigName и ConfigValue.

Свойства параметров

Тип:

String[]

Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateSettingsGroup
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroupGuid
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroupGeneric
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
RemoveMultipleSettings
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
UpdateMultipleSettings
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ConfigValue

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр ConfigValue указывает значение параметра Exchange, указанное с помощью параметра ConfigName. Значения определяются типом параметра (число, временной диапазон, $true, $false и т. д).

Параметр ConfigValue невозможно использовать вместе с параметром ConfigPairs.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateSetting
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

  • Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.

Этот командлет имеет встроенную паузу, поэтому используйте -Confirm:$false его, чтобы пропустить подтверждение.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-CreateSettingsGroup

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Ключ CreateSettingsGroup указывает, что вы создаете группу параметров Exchange, которая является группой связанных параметров Exchange. С этим параметром не нужно указывать значение.

В зависимости от того, как вы хотите настроить группу параметров, вы используете параметр GroupName или параметр SettingsGroup, чтобы указать имя группы параметров Exchange. Будьте внимательны, так как существующую группу параметров невозможно переименовать.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateSettingsGroup
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroupGuid
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroupAdvanced
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroupGeneric
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Disable

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Ключ Disable указывает, что группа параметров Exchange отключена. С этим параметром не нужно указывать значение.

Этот параметр можно использовать только вместе с параметром CreateSettingsGroup.

Чтобы использовать этот переключатель для включения группы параметров Exchange, используйте следующий точный синтаксис -Disable:$false.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateSettingsGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroupGuid
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroupGeneric
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DisableGroup

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Вы можете использовать параметры DisableGroup и EnableGroup вместе в одной команде, чтобы одновременно включать и отключать разные группы параметров Exchange.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

EnableSettingsGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DomainController

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Свойства параметров

Тип:Fqdn
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EnableGroup

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Вы можете использовать параметры DisableGroup и EnableGroup вместе в одной команде, чтобы одновременно включать и отключать разные группы параметров Exchange.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

EnableSettingsGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ExpirationDate

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр ExpirationDate указывает дату и время окончания параметров Exchange, определенных указанной группой параметров Exchange.

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование короткого формата даты ММ/ДД/ГГГГ, введите 01.09.2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".

Параметр ExpirationDate можно использовать только с параметрами группы CreateSettingsGroup или UpdateSettings.

Свойства параметров

Тип:DateTime
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateSettingsGroup
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroupGuid
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroupGeneric
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
UpdateSettingsGroup
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Force

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-GenericScopeName

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр GenericScopeName указывает имя области. Доступные значения определяются схемой объекта настройки Exchange.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateSettingsGroupGeneric
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-GenericScopeValue

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр GenericScopeValue указывает значение области, указанное параметром GenericScopeName. Доступные значения определяются схемой объекта настройки Exchange.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateSettingsGroupGeneric
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-GroupName

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр GroupName определяет имя группы параметров Exchange в групповых операциях. Например, вы можете:

  • Создайте группы параметров Exchange и одновременно настройте области и приоритет группы.
  • Изменение значений ExpirationDate, Priority и ScopeFilter существующих групп параметров Exchange.
  • Удалите существующие группы параметров Exchange.
  • Добавление, удаление и обновление объектов параметров Exchange в существующих группах параметров Exchange.

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

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateSetting
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
RemoveSetting
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroupGuid
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroupGeneric
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
UpdateSettingsGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
RemoveMultipleSettings
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
RemoveSettingsGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
UpdateMultipleSettings
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-GuidMatch

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр GuidMatch определяет области группы параметров Exchange на основе GUID объекта (например, GUID базы данных почтового ящика). Этот параметр можно использовать со всеми значениями параметра Scope, кроме Forest.

Параметр GuidMatch используется только при создании групп параметров Exchange с помощью ключа CreateSettingsGroup с параметром GroupName.

Этот параметр невозможно использовать вместе с параметрами GenericScopeName, GenericScopeValue, MaxVersion, MinVersion и NameMatch.

Свойства параметров

Тип:Guid
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateSettingsGroupGuid
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр Identity указывает имя существующего объекта параметров Exchange, который содержит параметры Exchange, которые требуется настроить.

Значение этого параметра совпадает со значением параметра Name командлета New-ExchangeSetting при создании объекта Exchange settings.

Свойства параметров

Тип:ExchangeSettingsIdParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-MaxVersion

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр MaxVersion определяет области действия группы параметров Exchange в зависимости от версии объекта (например, версии Exchange, установленной на сервере). Этот параметр можно использовать со всеми значениями параметра Scope, кроме Forest.

Параметр MaxVersion используется вместе с параметром MinVersion только в том случае, если группы параметров Exchange создаются с помощью переключателя CreateSettingsGroup с параметром GroupName.

Этот параметр невозможно использовать вместе с параметрами GuidMatch, GenericScopeName и GenericScopeValue.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateSettingsGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MinVersion

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр MinVersion определяет области действия группы параметров Exchange в зависимости от версии объекта (например, версии Exchange, установленной на сервере). Этот параметр можно использовать со всеми значениями параметра Scope, кроме Forest.

Параметр MinVersion вместе с параметром MaxVersion используется только при создании групп параметров Exchange с помощью переключателя CreateSettingsGroup с параметром GroupName.

Этот параметр невозможно использовать вместе с параметрами GuidMatch, GenericScopeName и GenericScopeValue.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateSettingsGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-NameMatch

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр NameMatch указывает области группы параметров Exchange на основе имени объекта (например, имени процесса). Этот параметр можно использовать со всеми значениями параметра Scope, кроме Forest.

Параметр NameMatch используется только при создании групп параметров Exchange с помощью ключа CreateSettingsGroup с параметром GroupName.

Этот параметр невозможно использовать вместе с параметрами GuidMatch, GenericScopeName и GenericScopeValue.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateSettingsGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Priority

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр Priority определяет приоритет группы параметров Exchange. Значение приоритета для каждой группы должно быть уникальным. Чем меньше значение, тем выше приоритет.

Свойства параметров

Тип:Int32
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateSettingsGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroupGuid
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroupGeneric
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
UpdateSettingsGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Reason

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveSetting

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Ключ RemoveSetting указывает, что вы удаляете существующий параметр Exchange из объекта параметров Exchange. С этим параметром не нужно указывать значение.

Удаляемый параметр указывается с помощью параметра ConfigPairs или ConfigName.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RemoveSetting
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
RemoveMultipleSettings
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RemoveSettingsGroup

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Ключ RemoveSettingsGroup указывает, что вы удаляете группу параметров Exchange. С этим параметром не нужно указывать значение.

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RemoveSettingsGroup
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Scope

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр Scope определяет области объекта Exchange Settings. Допустимые значения:

  • Dag
  • База данных
  • Лес
  • Generic
  • Организация
  • Процесс
  • Сервер
  • Пользователь

Свойства параметров

Тип:ExchangeSettingsScope
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateSettingsGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroupGuid
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
CreateSettingsGroupGeneric
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ScopeFilter

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр ScopeFilter использует синтаксис фильтра OPATH для указания области действия группы параметров Exchange. Синтаксис: "Property -ComparisonOperator 'Value'" (например, "ServerRole -like 'Mailbox*'").

  • Заключите весь фильтр OPATH в двойные кавычки " ". Если фильтр содержит системные значения (например, $true, $false или $null), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные.
  • Property — это свойство с поддержкой фильтрации.
  • ComparisonOperator — это оператор сравнения OPATH (например -eq , для равенства и -like для строкового сравнения). Подробнее об операторах сравнения см. в статье about_Comparison_Operators.
  • Value — это значение свойства для поиска. Заключите текстовые значения и переменные в одиночные кавычки ('Value' или '$Variable'). Если значение переменной содержит одиночные кавычки, необходимо определить (избежать) одиночные кавычки, чтобы правильно развернуть переменную. Например, вместо '$User' используйте '$($User -Replace "'","''")'. Не заключайте целые числа или системные значения в кавычки (например, используйте 500, $true, $false, или $null вместо них).

Вы можете объединить несколько условий поиска в цепочку с помощью логических операторов -and и -or. Например, "Criteria1 -and Criteria2" или "(Criteria1 -and Criteria2) -or Criteria3".

Подробные сведения о фильтрах OPATH в Exchange см. в статье "Дополнительные сведения о синтаксисе OPATH".

Этот параметр нельзя использовать с параметром Scope и значением Forest или другими параметрами, связанными с областей.

Этот параметр используется только при обновлении групп параметров Exchange с помощью переключателя UpdateSettingsGroup с параметром GroupName.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateSettingsGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
UpdateSettingsGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SettingsGroup

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Параметр SettingsGroup указывает существующую группу параметров Exchange, которая используется для создания новой группы параметров или изменения существующей группы параметров.

Параметр SettingsGroup невозможно использовать вместе с параметром GroupName.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CreateSettingsGroupAdvanced
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
UpdateSettingsGroupAdvanced
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-UpdateSetting

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Ключ UpdateSetting указывает, что вы обновляете параметр Exchange в существующем объекте параметров Exchange. С этим параметром не нужно указывать значение.

Для настройки параметра Exchange используется параметр ConfigPairs или параметры ConfigName и ConfigValue.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateSetting
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
UpdateMultipleSettings
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-UpdateSettingsGroup

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Ключ UpdateSettingsGroup указывает, что вы изменяете группу параметров Exchange. С этим параметром не нужно указывать значение.

В зависимости от того, как вы хотите настроить группу параметров, вы можете использовать параметр GroupName или параметр SettingsGroup, чтобы указать группу параметров Exchange, которую вы хотите изменить.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UpdateSettingsGroup
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
UpdateSettingsGroupAdvanced
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.