Set-EmailAddressPolicy

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Используйте командлет Set-EmailAddressPolicy для изменения политик адресов электронной почты. В Exchange Online политики адресов электронной почты доступны только для Группы Microsoft 365.

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

Синтаксис

Set-EmailAddressPolicy
   [-Identity] <EmailAddressPolicyIdParameter>
   [-ConditionalCompany <MultiValuedProperty>]
   [-ConditionalCustomAttribute1 <MultiValuedProperty>]
   [-ConditionalCustomAttribute10 <MultiValuedProperty>]
   [-ConditionalCustomAttribute11 <MultiValuedProperty>]
   [-ConditionalCustomAttribute12 <MultiValuedProperty>]
   [-ConditionalCustomAttribute13 <MultiValuedProperty>]
   [-ConditionalCustomAttribute14 <MultiValuedProperty>]
   [-ConditionalCustomAttribute15 <MultiValuedProperty>]
   [-ConditionalCustomAttribute2 <MultiValuedProperty>]
   [-ConditionalCustomAttribute3 <MultiValuedProperty>]
   [-ConditionalCustomAttribute4 <MultiValuedProperty>]
   [-ConditionalCustomAttribute5 <MultiValuedProperty>]
   [-ConditionalCustomAttribute6 <MultiValuedProperty>]
   [-ConditionalCustomAttribute7 <MultiValuedProperty>]
   [-ConditionalCustomAttribute8 <MultiValuedProperty>]
   [-ConditionalCustomAttribute9 <MultiValuedProperty>]
   [-ConditionalDepartment <MultiValuedProperty>]
   [-ConditionalStateOrProvince <MultiValuedProperty>]
   [-Confirm]
   [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
   [-DomainController <Fqdn>]
   [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
   [-EnabledPrimarySMTPAddressTemplate <String>]
   [-ForceUpgrade]
   [-IncludedRecipients <WellKnownRecipientType>]
   [-Name <String>]
   [-Priority <EmailAddressPolicyPriority>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-RecipientFilter <String>]
   [-WhatIf]
   [<CommonParameters>]

Описание

После использования командлета Set-EmailAddressPolicy для изменения политики адресов электронной почты в локальной организации Exchange необходимо использовать командлет Update-EmailAddressPolicy, чтобы применить обновленную политику к получателям.

Для условных параметров, используемых вместе с параметром IncludedRecipients, действуют следующие ограничения:

  • Оператор EQV используется для всех значений свойств, как, например, в выражении "Отдел равно Продажи". Подстановочные знаки и частичные совпадения не поддерживаются.
  • Если для одного свойства используется несколько значений, то всегда применяется оператор OR, как, например, в выражении "Отдел равно Продажи OR Маркетинг".
  • Если используется несколько свойств, то всегда применяется оператор AND, как, например, в выражении "Отдел равно Продажи AND Компания равно Contoso".

Чтобы создать гибкие фильтры, использующие любое доступное свойство получателя и не на которые распространяются эти ограничения, можно использовать параметр RecipientFilter для создания настраиваемого фильтра OPATH.

Этот командлет нельзя использовать для замены предварительно подготовленного фильтра пользовательским фильтром OPATH или наоборот. Изменить можно только существующий фильтр.

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

Примеры

Пример 1

Set-EmailAddressPolicy -Identity "Southeast Executives" -ConditionalStateOrProvince @{Add="TX"}

В локальной среде Exchange в этом примере изменяется существующая политика адресов электронной почты с именем Southeast Executives путем добавления значения штата или провинции TX (Техас) в предварительно настроенный фильтр получателей.

Пример 2

Set-EmailAddressPolicy -Identity "Contoso Corp" -DisabledEmailAddressTemplates $null

В локальной среде Exchange этот пример очищает отключенные шаблоны адресов электронной почты из политики адресов электронной почты Contoso Corp.

Пример 3

Set-EmailAddressPolicy -Identity "Office 365 Groups" -EnabledEmailAddressTemplates "SMTP:@contoso.com","smtp:@contoso.onmicrosoft.com","smtp:@contoso.microsoftonline.com"

В Exchange Online этот пример изменяет существующую политику адресов электронной почты с именем "Office 365 Groups" и задает включенные шаблоны адресов электронной почты для использования "@contoso.com" в качестве основного SMTP-адреса и "@contoso.onmicrosoft.com" и "@contoso.microsoftonline.com" в качестве прокси-адресов.

Параметры

-ConditionalCompany

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

Параметр ConditionalCompany указывает заранее подготовленный фильтр, основанный на значении свойства получателя Company.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalCustomAttribute1

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

Параметр ConditionalCustomAttribute1 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute1. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalCustomAttribute10

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

Параметр ConditionalCustomAttribute10 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute10. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalCustomAttribute11

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

Параметр ConditionalCustomAttribute11 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute11. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalCustomAttribute12

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

Параметр ConditionalCustomAttribute12 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute12. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalCustomAttribute13

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

Параметр ConditionalCustomAttribute13 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute13. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalCustomAttribute14

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

Параметр ConditionalCustomAttribute14 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute14. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalCustomAttribute15

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

Параметр ConditionalCustomAttribute15 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute15. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalCustomAttribute2

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

Параметр ConditionalCustomAttribute2 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute2. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalCustomAttribute3

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

Параметр ConditionalCustomAttribute3 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute3. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalCustomAttribute4

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

Параметр ConditionalCustomAttribute4 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute4. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalCustomAttribute5

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

Параметр ConditionalCustomAttribute5 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute5. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalCustomAttribute6

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

Параметр ConditionalCustomAttribute6 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute6. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalCustomAttribute7

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

Параметр ConditionalCustomAttribute7 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute7. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalCustomAttribute8

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

Параметр ConditionalCustomAttribute8 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute8. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalCustomAttribute9

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

Параметр ConditionalCustomAttribute9 указывает заранее подготовленный фильтр, основанный на значении свойства получателя CustomAttribute9. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalDepartment

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

Параметр ConditionalDepartment указывает заранее подготовленный фильтр, основанный на значении свойства получателя Department. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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

-ConditionalStateOrProvince

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

Параметр ConditionalStateOrProvince указывает заранее подготовленный фильтр, основанный на значении свойства получателя StateOrProvince. Вы можете указать несколько значений, разделив их запятыми.

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

Чтобы ввести несколько значений, которые перезаписывают все существующие записи, используйте следующий синтаксис: Value1,Value2,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
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, Exchange Online, Exchange Online Protection

-DisabledEmailAddressTemplates

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

Параметр DisabledEmailAddressTemplates указывает шаблоны адресов электронной почты прокси-сервера, которые включены в политику адресов электронной почты, но не используются для настройки адресов электронной почты получателей.

Допустимый синтаксис для этого параметра:Type:AddressFormat

  • Тип: допустимый тип адреса электронной почты, как описано в разделе "Типы адресов" Email политики адресов в Exchange Server. Например, SMTP или X400. Обратите внимание, что вы не можете использовать SMTP для указания отключенного основного SMTP-адреса электронной почты.
  • AddressFormat: для SMTP-адресов электронной почты домен или поддомен, настроенный как обслуживаемый домен (полномочный или внутренний ретранслятор), а также допустимые переменные и текстовые символы ASCII, как описано в разделе "Форматы адресов" статьи Email политики адресов в Exchange Server. Например, alias@contoso.com требуется значение %m@contoso.com, а firstname.lastname@contoso.com — значение %g.%s@contoso.com.

Можно указать несколько отключенных шаблонов адресов электронной почты, разделенных запятыми: "[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN".

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

Type:ProxyAddressTemplateCollection
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

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

Параметр 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

-EnabledEmailAddressTemplates

Чтобы настроить заблокированные типы файлов, используйте параметр FileTypes.

Допустимый синтаксис для этого параметра:Type:AddressFormat

  • Тип: допустимый тип адреса электронной почты, как описано в разделе "Типы адресов" Email политики адресов в Exchange Server. Пример: SMTP для основных электронных адресов и smtp для прокси-адресов.
  • AddressFormat: для SMTP-адресов электронной почты домен или поддомен, настроенный как обслуживаемый домен (полномочный или внутренний ретранслятор), а также допустимые переменные и текстовые символы ASCII, как описано в разделе "Форматы адресов" статьи Email политики адресов в Exchange Server. Например, alias@contoso.com требуется значение %m@contoso.com, а firstname.lastname@contoso.com — значение %g.%s@contoso.com.

Для этого параметра требуется по крайней мере один шаблон со значением ТИПА SMTP (для определения основного SMTP-адреса электронной почты). После этого, если не включить префикс type для шаблона, предполагается значение SMTP (прокси-адрес SMTP).

Можно указать несколько шаблонов адресов электронной почты, разделенных запятыми: "SMTP:PrimarySMTPEmailAddress","[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN".

Этот параметр нельзя использовать с параметром EnabledPrimarySMTPAddressTemplate.

В Exchange Online PowerShell, если вы используете этот параметр с IncludeUnifiedGroupRecipients, вы не сможете использовать переменные в шаблоне адреса электронной почты.

Type:ProxyAddressTemplateCollection
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, Exchange Online, Exchange Online Protection

-EnabledPrimarySMTPAddressTemplate

Параметр EnabledPrimarySMTPAddressTemplate указывает правило в политике адресов электронной почты, которая используется для создания основных SMTP-адресов электронной почты для получателей. Этот параметр можно использовать вместо EnabledEmailAddressTemplates, если политика применяет только основной адрес электронной почты и дополнительные прокси-адреса.

Допустимый синтаксис для этого параметра — это домен или поддомен, настроенный в качестве допустимого принятого домена, а допустимые переменные и текстовые символы ASCII, как описано в разделе "Формат адреса" Email политики адресов в Exchange Server. Например, alias@contoso.com требуется значение %m@contoso.com, а firstname.lastname@contoso.com — значение %g.%s@contoso.com.

Этот параметр нельзя использовать с параметром EnabledEmailAddressTemplates.

В Exchange Online PowerShell, если вы используете этот параметр с IncludeUnifiedGroupRecipients, вы не сможете использовать переменные в шаблоне адреса электронной почты.

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, Exchange Online, Exchange Online Protection

-ForceUpgrade

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

Type:SwitchParameter
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, Exchange Online, Exchange Online Protection

-Identity

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

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

-IncludedRecipients

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

Параметр IncludedRecipients указывает заранее подготовленный фильтр, основанный на типе получателя. Допустимые значения:

  • AllRecipients: Это значение используется только им самим.
  • MailboxUsers
  • MailContacts
  • MailGroups
  • MailUsers
  • Resources: Это значение обозначает почтовые ящики помещения или оборудования.

Вы можете указать несколько значений, разделив их запятыми. Если вы используете несколько значений, необходимо применять логический оператор OR.

Type:WellKnownRecipientType
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

-Name

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

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, Exchange Online, Exchange Online Protection

-Priority

Параметр Priority указывает порядок оценки политик адресов электронной почты. По умолчанию при каждом добавлении новой политики адресов электронной почты политике назначается приоритет N+1, где N — количество созданных вами политик адресов электронной почты.

Параметр Priority задает порядок оценки политик адресов электронной почты. По умолчанию каждый раз, когда вы добавляете новую политику электронных адресов, ей назначается приоритет N+1, где N — это количество созданных политик адресов электронной почты.

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

Type:EmailAddressPolicyPriority
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, Exchange Online, Exchange Online Protection

-RecipientContainer

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

Параметр RecipientContainer указывает фильтр, основанный на расположении получателя в Active Directory. Допустимые значения для этого параметра — подразделение или домен, которые возвращаются с помощью командлета Get-OrganizationalUnit. Вы можете использовать любое значение, уникальным образом определяющее подразделение или домен. Пример:

  • Имя
  • Имя
  • различающееся имя (DN);
  • GUID

GUID

Type:OrganizationalUnitIdParameter
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

-RecipientFilter

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

Параметр RecipientFilter задает пользовательский фильтр OPATH, основанный на значении любого доступного свойства recipient. Вы можете использовать любой доступный оператор Windows PowerShell. Кроме того, поддерживаются подстановочные знаки и частичные совпадения. Для критериев поиска используется следующий синтаксис: "Property -ComparisonOperator 'Value'".

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

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

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

-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, Exchange Online, Exchange Online Protection

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

Input types

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

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

Output types

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