Set-HostedContentFilterRule

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Online, Exchange Online Protection

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

Используйте командлет Set-HostedContentFilterRule, чтобы изменить правила фильтрации нежелательной почты (правила фильтрации содержимого) в облачной организации.

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

Синтаксис

Set-HostedContentFilterRule
   [-Identity] <RuleIdParameter>
   [-Comments <String>]
   [-Confirm]
   [-ExceptIfRecipientDomainIs <Word[]>]
   [-ExceptIfSentTo <RecipientIdParameter[]>]
   [-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
   [-HostedContentFilterPolicy <HostedContentFilterPolicyIdParameter>]
   [-Name <String>]
   [-Priority <Int32>]
   [-RecipientDomainIs <Word[]>]
   [-SentTo <RecipientIdParameter[]>]
   [-SentToMemberOf <RecipientIdParameter[]>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Важно!

Различные типы условий получателя или различные типы исключений получателей не являются аддитивные; они инклюзивные. Дополнительные сведения см. в статье Создание политик защиты от нежелательной почты с помощью портала Microsoft 365 Defender.

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

Примеры

Пример 1

Set-HostedContentFilterRule "Contoso Recipients" -ExceptIfSentToMemberOf "Contoso Human Resources"

В этом примере добавляется исключение в правило фильтрации спама с именем Contoso Recipients для членов группы рассылки Contoso Human Resources.

Параметры

-Comments

Параметр Comments определяет информативные комментарии к правилу, например о назначении правила или о том, какие изменения в него уже вносились. Длина комментария не должна превышать 1024 символов.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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 Online, Exchange Online Protection

-ExceptIfRecipientDomainIs

Параметр ExceptIfRecipientDomainIs указывает исключение для правила, которое ищет получателей с адресами электронной почты в указанных доменах. Можно указать несколько доменов, разделенных запятыми.

Type:	Word[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ExceptIfSentTo

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

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

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

Type:	RecipientIdParameter[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ExceptIfSentToMemberOf

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

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

PD_UCC_Multiple_Values

Type:	RecipientIdParameter[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-HostedContentFilterPolicy

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

Вы можете использовать любое уникальное значение, определяющее политику. Например, можно указать имя, GUID или различающееся имя (DN) политики фильтрации нежелательной почты.

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

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

-Identity

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

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

Type:	RuleIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Name

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

Не используйте следующие символы в значении имени: \ % & * + / = ? { } | < > ( ) ; : [ ] , ".

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

-Priority

Параметр Priority задает значение приоритета для правила, определяющее порядок обработки правила. Меньшее целочисленное значение указывает на более высокий приоритет, значение 0 — наивысший приоритет, а правила не могут иметь одинаковое значение приоритета.

Допустимые значения и значение по умолчанию для этого параметра зависят от количества существующих правил. Например, если существует 8 существующих правил:

Допустимые значения и значение, используемое по умолчанию, для этого параметра зависят от количества имеющихся правил. Например, у вас имеется 8 правил.
Допустимые значения приоритета для 9-го нового правила — от 0 до 8.
Значение по умолчанию для нового 9-го правила — 8.

При изменении значения приоритета правила позиция правила в списке изменится в соответствии со значением приоритета, которое вы указали. Иными словами, если задать для правила то же значение приоритета, что и существующее правило, значение приоритета существующего правила и всех других правил с более низким приоритетом после его увеличения на 1.

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

-RecipientDomainIs

Параметр RecipientDomainIs задает условие для правила, которое ищет получателей с адресами электронной почты в указанных доменах. Можно указать несколько доменов, разделенных запятыми.

Type:	Word[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SentTo

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

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

Type:	RecipientIdParameter[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SentToMemberOf

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

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

PD_UCC_Multiple_Values

Type:	RecipientIdParameter[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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 Online, Exchange Online Protection

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

Input types

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

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

Output types

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