New-EmailAddressPolicy
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.
Командлет New-EmailAddressPolicy позволяет создавать политики электронных адресов. В Exchange Online политики адресов электронной почты доступны только для Группы Microsoft 365.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
-IncludedRecipients <WellKnownRecipientType>
[-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>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
-RecipientFilter <String>
[-Confirm]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
-IncludedRecipients <WellKnownRecipientType>
[-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]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
-RecipientFilter <String>
[-Confirm]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
[-IncludeUnifiedGroupRecipients]
[-ManagedByFilter <String>]
[-Confirm]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
[-IncludeUnifiedGroupRecipients]
[-ManagedByFilter <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] Описание
После использования командлета New-EmailAddressPolicy для создания политики адресов электронной почты в локальной организации Exchange необходимо применить новую политику к получателям с помощью командлета Update-EmailAddressPolicy.
Для условных параметров, используемых вместе с параметром IncludedRecipients, действуют следующие ограничения:
- Оператор EQV используется для всех значений свойств, как, например, в выражении "Отдел равно Продажи". Подстановочные знаки и частичные совпадения не поддерживаются.
- Если для одного свойства используется несколько значений, то всегда применяется оператор OR, как, например, в выражении "Отдел равно Продажи OR Маркетинг".
- Если используется несколько свойств, то всегда применяется оператор AND, как, например, в выражении "Отдел равно Продажи AND Компания равно Contoso".
Чтобы создать гибкие фильтры, использующие любое доступное свойство получателя и не на которые распространяются эти ограничения, можно использовать параметр RecipientFilter для создания фильтра OPATH.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
New-EmailAddressPolicy -Name "Southeast Offices" -IncludedRecipients MailboxUsers -ConditionalStateorProvince "GA","AL","LA" -EnabledEmailAddressTemplates "SMTP:%s%2g@southeast.contoso.com","smtp:%s%2g@southeast.contoso.net"В этом примере создается политика адресов электронной почты в локальной организации Exchange, которая использует предканированный фильтр получателей:
- Название: Юго-Восточные офисы
- Предуклонированный фильтр получателей: все пользователи с почтовыми ящиками, где значение штата или провинции — GA, AL или LA (Джорджия, Алабама или Луизиана).
- Основной SMTP-адрес электронной почты:
<last name>.<first two letters of the first name>@contoso.com - Дополнительные адреса электронной почты прокси-сервера:
<last name>.<first two letters of the first name>@contoso.net - Priority:N+1, где N — это количество уже созданных вручную политик адресов электронной почты (мы не использовали параметр Priority, а значение по умолчанию — N+1).
Пример 2
New-EmailAddressPolicy -Name "Northwest Executives" -RecipientFilter "(RecipientType -eq 'UserMailbox') -and (Title -like '*Director*' -or Title -like '*Manager*') -and (StateOrProvince -eq 'WA' -or StateOrProvince -eq 'OR' -or StateOrProvince -eq 'ID')" -EnabledEmailAddressTemplates "SMTP:%2g%s@contoso.com" -Priority 2В этом примере создается политика адресов электронной почты в локальной организации Exchange, которая использует настраиваемый фильтр получателей:
- Имя: Северо-Западные руководители
- Настраиваемый фильтр получателей: все пользователи с почтовыми ящиками, в которых значение Title содержит Director или Manager, а значение штата или провинции — WA, OR или ID (Вашингтон, Орегон или Айдахо).
- Основной SMTP-адрес электронной почты:
<first two letters of the first name><last name>@contoso.com - Дополнительные адреса электронной почты прокси-сервера: нет
- Приоритет: 2
Параметры
-ConditionalCompany
Этот параметр доступен только в локальной среде Exchange.
Параметр ConditionalCompany указывает заранее подготовленный фильтр, основанный на значении свойства получателя Company. Вы можете указать несколько значений, разделив их запятыми.
Если вы используете несколько значений для этого параметра, необходимо применять логический оператор OR. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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. Подробнее о том, как работают условные параметры, см. в разделе "Подробное описание" этой статьи.
Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| 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 |
-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".
| 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 нельзя использовать переменные в шаблоне адреса электронной почты.
| Type: | ProxyAddressTemplateCollection |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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 нельзя использовать переменные в шаблоне адреса электронной почты.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludedRecipients
Этот параметр доступен только в локальной среде Exchange.
Параметр IncludedRecipients указывает заранее подготовленный фильтр, основанный на типе получателя. Допустимые значения:
- AllRecipients: Это значение используется только им самим.
- MailboxUsers
- MailContacts
- MailGroups
- MailUsers
- Resources: Это значение обозначает почтовые ящики помещения или оборудования.
Вы можете указать несколько значений, разделив их запятыми. Если вы используете несколько значений, необходимо применять логический оператор OR.
Этот параметр необходимо использовать при использовании любых условных параметров в составе заранее подготовленного фильтра. Этот параметр нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).
| Type: | WellKnownRecipientType |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IncludeUnifiedGroupRecipients
Этот параметр доступен только в облачной службе.
Параметр IncludeUnifiedGroupRecipients указывает, что политика адресов электронной почты применяется только к Группы Microsoft 365. Указывать значение для этого параметра необязательно.
В Exchange Online PowerShell этот параметр всегда необходимо использовать, так как политики адресов электронной почты в Exchange Online применяются только к группам Майкрософт 365.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ManagedByFilter
Этот параметр доступен только в облачной службе.
Параметр ManagedByFilter задает политики адресов электронной почты, применяемые к Группы Microsoft 365 на основе свойств пользователей, создающих Группы Microsoft 365.
Этот параметр является фильтром OPATH, основанным на значении любого доступного свойства получателя (например, "Department -eq 'Sales'"). Вы можете использовать любой доступный оператор 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'— нет.
Дополнительные сведения см. в разделе Выбор домена для использования при создании Группы Microsoft 365.
Подробные сведения о фильтрах OPATH в Exchange см. в разделе Дополнительные сведения о синтаксисе OPATH.
Этот параметр можно использовать только в Exchange Online PowerShell с параметром IncludeUnifiedGroupRecipients.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Name
Параметр Name указывает уникальное имя политики электронных адресов. Максимальная длина: 64 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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 |
-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'— нет. - В локальной среде Exchange подстановочные знаки действительны только в качестве первого или последнего символа. Например,
'Sales*'или'*Sales'разрешено, а'Sa*les'— нет.
Подробные сведения о фильтрах OPATH в Exchange см. в разделе Дополнительные сведения о синтаксисе OPATH.
Этот параметр нельзя использовать в сочетании с параметром IncludedRecipients или любыми условными параметрами (которые используются для создания заранее подготовленных фильтров).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.