New-DynamicDistributionGroup

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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

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

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

Синтаксис

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>]
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 "(RecipientType -eq 'UserMailbox') -and (Title -like 'Director*' -or Title -like 'Manager*') -and (StateOrProvince -eq 'WA')" -RecipientContainer "North America"

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

Параметры

-Alias

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

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

  • !, #, %, *, +, -, /, =, ?, ^, _, и ~.
  • $, &, ', ', {, }и | должны быть экранированы (например -Alias what`'snew, ) или все значение заключено в одинарные кавычки (например, -Alias 'what'snew'). Символ & не поддерживается в значении Псевдоним для синхронизации Azure AD 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 никогда не создает и не изменяет основной электронный адрес почтового контакта или почтового пользователя.

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

-ArbitrationMailbox

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

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

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Домен\Имя пользователя
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя
Type:MailboxIdParameter
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

-ConditionalCompany

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalCustomAttribute1

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalCustomAttribute10

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalCustomAttribute11

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalCustomAttribute12

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalCustomAttribute13

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalCustomAttribute14

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalCustomAttribute15

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalCustomAttribute2

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalCustomAttribute3

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalCustomAttribute4

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalCustomAttribute5

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalCustomAttribute6

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalCustomAttribute7

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalCustomAttribute8

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalCustomAttribute9

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalDepartment

Параметр 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, Exchange Online, Exchange Online Protection

-ConditionalStateOrProvince

Параметр 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, Exchange Online, Exchange Online Protection

-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

-DirectMembershipOnly

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

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

Type:Boolean
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-DisplayName

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

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

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

-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

-IncludedRecipients

Параметр 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, Exchange Online, Exchange Online Protection

-ModeratedBy

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

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

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

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

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

-ModerationEnabled

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

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

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

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

-Name

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

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

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

-OrganizationalUnit

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

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

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

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

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

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

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

-PrimarySmtpAddress

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

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

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

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

GUID

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

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

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

-RecipientFilter

Параметр 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 символов, включая внутренний синтаксис.

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

-SendModerationNotifications

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

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

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

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

-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

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