Add-AttachmentFilterEntry

  • Статья

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2009-04-28

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

Синтаксис

add-attachmentfilterentry -Name <String> -Type <ContentType | FileName> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

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

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

    noteПримечание.
    UNRESOLVED_TOKEN_VAL(exNote3rdPartyURL)

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

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

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

Параметры

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

Name

Обязательный

System.String

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

Type

Обязательный

Microsoft.Exchange.Data.Directory.SystemConfiguration.AttachmentType

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

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

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

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Значение параметра Confirm указывать не требуется.

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

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

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

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

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

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

Ошибки

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

Пример

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

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

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

add-attachmentfilterentry -name *.txt -type FileName
add-attachmentfilterentry -name image/jpeg -type ContentType