Поделиться через

New-DynamicDistributionGroup

Модуль:
Exchange PowerShell

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

Командлет New-DynamicDistributionGroup используется для создания динамических групп рассылки. Динамическая группа рассылки запрашивает объекты, поддерживающие почту, и организует участие в группе на основе результатов данного запроса. Участие в группе определяется заново каждый раз при отправке в эту группу электронного сообщения.

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

Синтаксис

PrecannedFilter 

New-DynamicDistributionGroup
    [-Name] <String>
    -IncludedRecipients <WellKnownRecipientType>
    [-Alias <String>]
    [-ArbitrationMailbox <MailboxIdParameter>]
    [-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]
    [-DirectMembershipOnly <Boolean>]
    [-DisplayName <String>]
    [-DomainController <Fqdn>]
    [-ModeratedBy <MultiValuedProperty>]
    [-ModerationEnabled <Boolean>]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-PrimarySmtpAddress <SmtpAddress>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-SendModerationNotifications <TransportModerationNotificationFlags>]
    [-WhatIf]
    [<CommonParameters>]

CustomFilter 

New-DynamicDistributionGroup
    [-Name] <String>
    -RecipientFilter <String>
    [-Alias <String>]
    [-ArbitrationMailbox <MailboxIdParameter>]
    [-Confirm]
    [-DirectMembershipOnly <Boolean>]
    [-DisplayName <String>]
    [-DomainController <Fqdn>]
    [-ModeratedBy <MultiValuedProperty>]
    [-ModerationEnabled <Boolean>]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-PrimarySmtpAddress <SmtpAddress>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-SendModerationNotifications <TransportModerationNotificationFlags>]
    [-WhatIf]
    [<CommonParameters>]

Описание

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

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

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

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

Примеры

Пример 1

New-DynamicDistributionGroup -Name "Marketing Group" -IncludedRecipients "MailboxUsers,MailContacts" -ConditionalDepartment "Marketing","Sales"

В этом примере создается динамическая группа рассылки под названием Marketing Group, включающая в себя всех получателей, для которых в поле Department указано значение Marketing или Sales. Поскольку мы не использовали параметры OrganizationalUnit или RecipientContainer, группа находит получателей в расположении по умолчанию (как правило, это контейнер пользователей).

Пример 2

New-DynamicDistributionGroup -Name "Washington Management Team" -RecipientFilter "(RecipientTypeDetails -eq 'UserMailbox') -and (Title -like 'Director*' -or Title -like 'Manager*') -and (StateOrProvince -eq 'WA')" -RecipientContainer "North America"

В этом примере создается динамическая группа рассылки с именем Washington Management Team, которая содержит всех пользователей в подразделении с именем Северная Америка из штата Вашингтон, названия которых начинаются с "Director" или "Manager".

Параметры

-Alias

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

Параметр Alias указывает псевдоним Exchange (также называемый почтовым псевдонимом) получателя. Это значение идентифицирует получателя как объект, поддерживающий почту. Не следует путать его с несколькими электронными адресами для одного и того же получателя (также называемыми прокси-адресами). У получателя может быть только одно значение Alias. Максимальная длина: 64 символа.

Значение Alias может содержать буквы, цифры и следующие символы:

  • !, #, %, *, +, -, /, =, ?, ^, _, и ~.
  • $, &, ', ', {, }и | необходимо экранировать (например -Alias what`'snew, ) или все значение, заключенное в одинарные кавычки (например, -Alias 'what'snew'). Символ & не поддерживается в значении Псевдоним для синхронизации Microsoft Entra Connect.
  • Точки (.) должны быть окружены другими допустимыми символами (например, help.desk).
  • Символы Юникода от U+00A1 до U+00FF.

Если при создании получателя не указать электронный адрес, то заданное значение Alias будет использовано для создания основного электронного адреса (alias@domain). Поддерживаемые символы Юникода сопоставляются с наиболее подходящими текстовыми символами US-ASCII. Например, U+00F6 (ö) изменяется на oe в основной адрес электронной почты.

Если при создании получателя не использовать параметр Alias, то в качестве значения свойства Alias будет использовано значение другого обязательного параметра:

  • Для получателей с учетными записями пользователей (например, почтовые ящики пользователей и почтовые пользователи) используется левая часть параметра MicrosoftOnlineServicesID или параметр UserPrincipalName. Например, helpdesk@contoso.onmicrosoft.com возвращает значение helpdeskсвойства Alias .
  • Для получателей без учетных записей пользователей (например, почтовые ящики переговорных комнат, почтовые контакты и группы рассылки) используется значение параметра Name. Пробелы будут удалены, а неподдерживаемые символы преобразованы в знаки вопроса (?).

Если изменить значение параметра Alias существующего получателя, основной электронный адрес будет автоматически обновлен только в локальных средах, где в отношении получателя действуют политики электронных адресов (для получателя свойство EmailAddressPolicyEnabled имеет значение True).

Параметр Alias никогда не создает и не изменяет основной электронный адрес почтового контакта или почтового пользователя.

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

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

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

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

-ArbitrationMailbox

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

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

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Домен\Имя пользователя
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя

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

Тип:MailboxIdParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCompany

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCustomAttribute1

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCustomAttribute10

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCustomAttribute11

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCustomAttribute12

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCustomAttribute13

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCustomAttribute14

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCustomAttribute15

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCustomAttribute2

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCustomAttribute3

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCustomAttribute4

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCustomAttribute5

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCustomAttribute6

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCustomAttribute7

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCustomAttribute8

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalCustomAttribute9

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalDepartment

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ConditionalStateOrProvince

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Этот параметр используется в сочетании с параметром IncludedRecipients в составе заранее подготовленного фильтра. Условные параметры нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Confirm

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

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

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Cf

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

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

-DirectMembershipOnly

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

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

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

Тип:Boolean
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-DisplayName

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

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

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

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

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

-DomainController

Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE

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

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

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

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

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

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

-IncludedRecipients

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

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

Этот параметр необходимо использовать при использовании любых условных параметров в составе заранее подготовленного фильтра. Этот параметр нельзя использовать в сочетании с параметром RecipientFilter (который используется для создания пользовательских фильтров OPATH).

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

Тип:WellKnownRecipientType
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ModeratedBy

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

Параметр ModeratedBy определяет одного или нескольких модераторов для данного получателя. Модератор утверждает сообщения, отправленные получателю, перед их доставкой. В качестве модератора должен выступать почтовый ящик, почтовый пользователь или почтовый контакт в организации. Для идентификации модератора можно использовать любое уникальное значение. Например:

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Каноническое краткое имя
  • GUID

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

Этот параметр используется для указания по крайней мере одного модератора при задании параметра ModerationEnabled значения $true.

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

Тип:MultiValuedProperty
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ModerationEnabled

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

Параметр ModerationEnabled указывает, включена ли модерация для этого получателя. Допустимые значения:

  • $true. Для этого получателя включена модерация. Сообщения, отправленные этому получателю, должны быть утверждены модератором перед доставкой сообщений.
  • $true. Модерирование включено для этого получателя. Это значение является значением по умолчанию.

Для указания модераторов используется параметр ModeratedBy.

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

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Name

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

Это значение также используется для свойства DisplayName, если не применяется параметр DisplayName.

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

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

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

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

-OrganizationalUnit

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

Параметр OrganizationalUnit указывает подразделение, в котором создается динамическая группа рассылки.

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

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

Если этот параметр не используется, по умолчанию обычно используется контейнер Users в домене сервера Exchange Server, к которому вы подключены (также известный как получатель область). В локальной среде Exchange можно изменить область получателя для текущего сеанса PowerShell с помощью командлета Set-AdServerSettings.

Если параметр RecipientContainer не используется, расположение динамической группы рассылки используется для свойства RecipientContainer (расположение по умолчанию или значение, указанное для параметра OrganizationalUnit).

Примечание. Хотя этот параметр доступен в Exchange Online, в Exchange Online организации существует только одно доступное подразделение, поэтому использование этого параметра не оказывает влияния.

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

Тип:OrganizationalUnitIdParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-PrimarySmtpAddress

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Тип:SmtpAddress
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-RecipientContainer

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

GUID

Свойство RecipientContainer не может быть пустым. Поиск получателей для группы всегда ограничен определенным расположением (значением, которое вы указали для этого параметра или расположением, в котором была создана группа).

Примечание. Хотя этот параметр доступен в Exchange Online, в Exchange Online организации существует только одно доступное подразделение, поэтому использование этого параметра не оказывает влияния.

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

Тип:OrganizationalUnitIdParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-RecipientFilter

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

Параметр 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 или любыми условными параметрами (которые используются для создания заранее подготовленных фильтров).

Максимальная длина свойства RecipientFilter составляет 2048 символов, включая внутренний синтаксис.

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

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

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

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

-SendModerationNotifications

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

Службы клиентского доступа выступают в роли прокси-сервера, передавая подключения клиентов во внутренние службы на локальных или удаленных серверах почтовых ящиков. Допустимые значения:

  • Всегда: уведомлять всех отправителей о том, что их сообщения не утверждены. Это значение является значением по умолчанию.
  • Always. Уведомлять всех отправителей о том, что их сообщения не утверждены. Это значение используется по умолчанию.
  • Internal. Уведомлять отправителей вашей организации, если их сообщения не утверждены.

Этот параметр имеет смысл, только если модерация включена (параметр ModerationEnabled имеет значение $true).

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

Тип:TransportModerationNotificationFlags
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-WhatIf

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды Почтовых ящиков

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

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

Тип:SwitchParameter
Default value: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.

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

Input types

Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.

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

Output types

Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.