Командлет Set-RecipientFilterConfig используется для включения и настройки агента фильтра получателя на компьютере с установленной ролью пограничного транспортного сервера или ролью транспортного сервера-концентратора.

Синтаксис


Set-RecipientFilterConfig [-BlockedRecipients <MultiValuedProperty>] [-BlockListEnabled <$true \| $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true \| $false>] [-ExternalMailEnabled <$true \| $false>] [-Instance <RecipientFilterConfig>] [-InternalMailEnabled <$true \| $false>] [-RecipientValidationEnabled <$true \| $false>] [-WhatIf [<SwitchParameter>]]

Set-RecipientFilterConfig [-BlockedRecipients <MultiValuedProperty>] [-BlockListEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <RecipientFilterConfig>] [-InternalMailEnabled <$true | $false>] [-RecipientValidationEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Параметры

Параметр	Требуется	Тип	Описание
BlockedRecipients	Необязательный	Microsoft.Exchange.Data.MultiValuedProperty	Допустимыми входными данными параметра BlockedRecipients Enabled являются один или несколько адресов SMTP. Можно ввести до 800 отдельных адресов SMTP для параметра BlockedRecipients .
BlockListEnabled	Необязательный	System.Boolean	Допустимыми значениями параметра BlockListEnabled Enabled являются `$true` или `$false`. Значение по умолчанию: `$false`. Если значение параметра BlockListEnabled равно `$true`, то агент фильтра получателя блокирует сообщения, которые отправляются получателям, содержащимся в списке параметра BlockedRecipients.
Confirm	Необязательный	System.Management.Automation.SwitchParameter	Параметр Confirm используется для приостановки команды и требует подтверждения выполняемого ею действия. Указывать значение параметра Confirm не требуется.
DomainController	Необязательный	Microsoft.Exchange.Data.Fqdn	Чтобы указать полное доменное имя (FQDN) контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. Параметр DomainController не поддерживается на компьютерах с установленной ролью сервера «Граничный транспорт». Роль сервера «Граничный транспорт» производит запись только в локальный экземпляр ADAM.
Enabled	Необязательный	System.Boolean	Допустимыми значениями параметра Enabled являются `$true` или `$false`. Значение по умолчанию: `$true`. Если значение параметра Enabled равно `$true`, агент фильтра получателя включен на компьютере, на котором выполняется командлет `Set-RecipientFilterConfig`.
ExternalMailEnabled	Необязательный	System.Boolean	Допустимыми значениями параметра ExternalMailEnabled являются `$true` или `$false`. Значение по умолчанию: `$true`. Если значение параметра ExternalMailEnabled равно `$true`, все сообщения подключений, не прошедших проверку подлинности, передаются на обработку агенту фильтра получателя.
Instance	Необязательный	Microsoft.Exchange.Data.Directory.SystemConfiguration.RecipientFilterConfig	Параметр Instance позволяет отправить целый объект на обработку команде. Он обычно используется в сценариях, где целый объект должен быть отправлен команде.
InternalMailEnabled	Необязательный	System.Boolean	Допустимыми значениями параметра InternalMailEnabled являются `$true` или `$false`. Значение по умолчанию: `$false`. Если значение параметра InternalMailEnabled равно `$true`, все сообщения прошедших проверку подлинности доменов отправителей, принадлежащих удостоверяющим доменам на предприятии, передаются на обработку агенту фильтра получателя.
RecipientValidationEnabled	Необязательный	System.Boolean	Допустимыми значениями параметра RecipientValidationEnabled являются `$true` или `$false`. Значение по умолчанию: `$false`. Если значение параметра RecipientValidationEnabled равно `$true`, то агент фильтра получателя блокирует сообщения, которые содержат получателей, не существующих в организации.
WhatIf	Необязательный	System.Management.Automation.SwitchParameter	При использовании параметра WhatIf команда имитирует действия над объектом, которые она будет выполнять. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется.

Подробное описание

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

роль администратора сервера Exchange и членство в локальной группе администраторов на целевом сервере.

Чтобы выполнить командлет Set-RecipientFilterConfig на компьютере с установленной ролью пограничного транспортного сервера, необходимо войти в систему с помощью учетной записи, являющейся членом локальной группы администраторов этого компьютера.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Типы ввода

Типы возврата

Ошибки

Ошибка	Описание

Пример

В следующих примерах кода показаны две команды Set-RecipientFilterConfig.

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

Второй образец кода показывает, как включить список заблокированных получателей и как добавить получателей к списку заблокированных получателей.

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

	Копировать код
Set-RecipientFilterConfig -RecipientValidationEnabled:$true Set-RecipientFilterConfig -BlockListEnabled:$true -BlockedRecipients user1@contoso.com,user2@contoso.com