Командлет Add-AttachmentFilterEntry используется для добавления элемента в список фильтра вложений на компьютере с установленной ролью пограничного транспортного сервера.

Синтаксис


add-attachmentfilterentry -Name <String> -Type <ContentType \| FileName> [-DomainController <Fqdn>]

Параметры

Параметр Обязательность Тип Описание

Параметр	Обязательность	Тип	Описание
Имя	Обязательность	System.String	Этот параметр определяет тип содержимого MIME или имя файла вложения. Если значение параметра Type равно `FileName`, для параметра Name можно задать любое точное имя файла, например `BadFile.Exe`, или расширение имени файла, например `.exe`. Если значение параметра Type* равно `ContentType`, для параметра Name можно задать любое допустимое значение типа содержимого MIME.
Тип	Обязательность	Microsoft.Exchange.Data.Directory.SystemConfiguration.AttachmentType	Этот параметр определяет, какой тип вложений будет блокирован данным элементом фильтра вложений. Допустимыми являются значения `ContentType` и `Filename`. ContentType. Это значение сопоставляет элементу фильтра вложений тип содержимого MIME, заданный параметром AttachmentName. FileName. Это значение сопоставляет элементу фильтра вложений простое имя файла, заданное параметром AttachmentName.
DomainController	Дополнительно	Microsoft.Exchange.Data.Fqdn	Чтобы указать полное доменное имя (FQDN) контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. Параметр DomainController не поддерживается компьютерами, на которых установлена серверная роль «Граничный транспорт». Серверная роль «Граничный транспорт» записывает только локальный экземпляр ADAM.

Имя

Обязательность

System.String

Этот параметр определяет тип содержимого MIME или имя файла вложения. Если значение параметра Type равно FileName, для параметра Name можно задать любое точное имя файла, например BadFile.Exe, или расширение имени файла, например *.exe. Если значение параметра Type равно ContentType, для параметра Name можно задать любое допустимое значение типа содержимого MIME.

Тип

Обязательность

Microsoft.Exchange.Data.Directory.SystemConfiguration.AttachmentType

Этот параметр определяет, какой тип вложений будет блокирован данным элементом фильтра вложений. Допустимыми являются значения ContentType и Filename.

ContentType. Это значение сопоставляет элементу фильтра вложений тип содержимого MIME, заданный параметром AttachmentName.
FileName. Это значение сопоставляет элементу фильтра вложений простое имя файла, заданное параметром AttachmentName.

DomainController

Дополнительно

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя (FQDN) контроллера домена, записывающего это изменение конфигурации в службу каталогов Active Directory, включите в команду параметр DomainController. Параметр DomainController не поддерживается компьютерами, на которых установлена серверная роль «Граничный транспорт». Серверная роль «Граничный транспорт» записывает только локальный экземпляр ADAM.

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

Агент фильтра вложений может, в зависимости от типа содержимого и имени файла вложения, блокировать попадание вложений в организацию Microsoft Exchange Server 2007. Конфигурация агента фильтрации вложений определяет порядок обработки вложений.

Дополнительные сведения о настройке агента фильтра вложений см. в разделе Командлет Set-AttachmentFilterListConfig (окончательная первоначальная версия).

Командлет Add-AttachmentFilterEntry может выполнять фильтрацию вложений электронной почты на основе типов содержимого MIME и имени файла. Следующий список содержит описание каждого из типов вложений:

Типы содержимого MIME. Типы содержимого MIME показывают, что представляет собой вложение, например является ли оно изображением JPEG, исполняемым файлом, файлом Microsoft Office Excel 2003 или файлом другого типа. Вложения электронной почты кодируются в сообщениях электронной почты как текст ASCII. Серверы и клиенты электронной почты используют сведения о типе содержимого MIME для декодирования данных текста ASCII в сообщении электронной почты и преобразования их в используемый двоичный файл, знакомый пользователю. Типы содержимого представлены как type/subtype. Например, тип содержимого «изображение JPEG» представлен как image/jpeg.

Дополнительные сведения о типах содержимого MIME см. в RFC 1341.
Имена файлов. Существует два способа указать имена файлов вложений в списках фильтра вложений. Можно задать точное имя файла, например Плохое_имя_файла.exe. Либо можно задать любой файл с расширением конкретного типа, заменяя имя файла слева от точки подстановочным знаком. Примером использования подстановочного знака в имени файла является *.exe.

Чтобы выполнить командлет Add-AttachmentFilterEntry на компьютере с установленной ролью пограничного транспортного сервера, необходимо войти в систему, используя учетную запись, входящую в локальную группу «Администраторы» данного компьютера.

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

Типы входных данных

Типы возвращаемых данных

Ошибки

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

Исключения

Исключения	Описание

Пример

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

Первый образец кода добавляет элемент фильтра вложений, использующий имя файла. Этот фильтр вложений будет применяться ко всем вложениям с расширением TXT.

Второй образец кода добавляет элемент фильтра вложений, использующий тип содержимого MIME image/jpeg, определяющий двоичный файл изображения JPEG. Этот фильтр вложений будет применяться ко всем вложениям, соответствующим типу содержимого MIME image/jpeg.

	Копировать код
add-attachmentfilterentry -name *.txt -type FileName add-attachmentfilterentry -name image/jpeg -type ContentType