Поделиться через


Get-QuarantineMessage

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

Используйте командлет Get-QuarantineMessage для просмотра сообщений и файлов в карантине в облачной организации. Файлы помещаются в карантин с помощью безопасных вложений для SharePoint, OneDrive и Microsoft Teams.

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

Синтаксис

Details

Get-QuarantineMessage
    -Identity <QuarantineMessageIdentity>
    [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
    [-RecipientAddress <String[]>]
    [-SenderAddress <String[]>]
    [-TeamsConversationTypes <Microsoft.Exchange.Management.FfoQuarantine.TeamsConversationType[]>]
    [<CommonParameters>]

Summary

Get-QuarantineMessage

    [-Direction <Microsoft.Exchange.Management.FfoQuarantine.QuarantineMessageDirectionEnum>]
    [-Domain <String[]>]
    [-EndExpiresDate <System.DateTime>]
    [-EndReceivedDate <System.DateTime>]
    [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
    [-IncludeMessagesFromBlockedSenderAddress]
    [-MessageId <String>]
    [-MyItems]
    [-Page <Int32>]
    [-PageSize <Int32>]
    [-PolicyName <String>]
    [-PolicyTypes <QuarantinePolicyTypeEnum[]>]
    [-QuarantineTypes <QuarantineMessageTypeEnum[]>]
    [-RecipientAddress <String[]>]
    [-RecipientTag <String[]>]
    [-ReleaseStatus <ReleaseStatus[]>]
    [-Reported <Boolean>]
    [-SenderAddress <String[]>]
    [-StartExpiresDate <System.DateTime>]
    [-StartReceivedDate <System.DateTime>]
    [-Subject <String>]
    [-TeamsConversationTypes <Microsoft.Exchange.Management.FfoQuarantine.TeamsConversationType[]>]
    [-Type <Microsoft.Exchange.Management.FfoQuarantine.QuarantineMessageTypeEnum>]
    [<CommonParameters>]

Описание

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

Примеры

Пример 1

Get-QuarantineMessage -StartReceivedDate 06/13/2017 -EndReceivedDate 06/15/2017

В этом примере возвращается сводный список сообщений, помещенных в карантин с 13 июня 2017 г. по 15 июня 2017 г.

Пример 2

Get-QuarantineMessage -PageSize 50 -Page 3

В этом примере представлено 50 сообщений в карантине на каждой странице и возвращается третья страница результатов.

Пример 3

Get-QuarantineMessage -MessageID "<5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com>"

В этом примере возвращается сообщение, помещенное в карантин, со значением <5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com>Message-ID .

Пример 4

Get-QuarantineMessage -Identity c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7 | Format-List

В этом примере возвращаются подробные сведения для сообщения, помещенного в карантин, с указанным значением Identity.

Пример 5

Get-QuarantineMessage -QuarantineTypes SPOMalware | Format-List

В этом примере возвращаются подробные сведения о файлах, защищенных безопасными вложениями для SharePoint, OneDrive и Microsoft Teams.

Параметры

-Direction

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр Direction фильтрует результаты по входящим или исходящим сообщениям. Допустимые значения:

  • Входящих
  • Исходящий

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

Свойства параметров

Тип:Microsoft.Exchange.Management.FfoQuarantine.QuarantineMessageDirectionEnum
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Domain

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

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

Свойства параметров

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EndExpiresDate

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

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

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если на компьютере настроен короткий формат даты ММ/дд/гггг, введите 01.09.2018, чтобы указать 1 сентября 2018 г. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".

Например, если указать значение StartExpiresDate для текущей даты и значение EndExpiresDate даты три дня с сегодняшнего дня, вы увидите только сообщения, срок действия которых истекает из карантина в течение следующих трех дней.

Свойства параметров

Тип:System.DateTime
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EndReceivedDate

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр EndReceivedDate указывает последние сообщения, возвращаемые в результатах. Используйте этот параметр с параметром StartReceivedDate.

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если на компьютере настроен короткий формат даты ММ/дд/гггг, введите 01.09.2018, чтобы указать 1 сентября 2018 г. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".

Свойства параметров

Тип:System.DateTime
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EntityType

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр EntityType фильтрует результаты по EntityType. Допустимые значения:

  • Электронная почта
  • SharePointOnline
  • Teams (в настоящее время находится в предварительной версии)
  • DataLossPrevention

Свойства параметров

Тип:Microsoft.Exchange.Management.FfoQuarantine.EntityType
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр Identity указывает сообщение, помещенное в карантин, которое требуется просмотреть. Значение является уникальным идентификатором сообщения в карантине в формате GUID1\GUID2 (например c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7, ).

При определении сообщения карантина с помощью этого параметра доступны свойства RecipientAddress, QuarantineUser и ReleasedUser. Чтобы увидеть эти значения, необходимо использовать командлет форматирования. Например, Get-QuarantineMessage -Identity <Identity> | Format-List.

Внимание! Значение $null или несуществующее значение для параметра Identity возвращает все объекты, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity являются точными и не содержат несуществующих $null значений.

Свойства параметров

Тип:QuarantineMessageIdentity
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Details
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-IncludeMessagesFromBlockedSenderAddress

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

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

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MessageId

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр MessageId фильтрует результаты по полю темы Message-ID сообщения. Это значение еще зовется идентификатором клиента. Формат Message-ID зависит от сервера обмена сообщениями, с которого было отправлено сообщение. Значение должно быть уникальным для каждого сообщения. Но не все серверы обмена сообщениями создают значения для параметра Message-ID одинаковым способом. Обязательно включите полную строку идентификатора сообщения (которая может включать угловые скобки) и заключите значение в кавычки (например, "<d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com>").

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MyItems

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

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

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Page

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр Page указывает номер страницы результатов, которую необходимо просмотреть. Допустимое значение для этого параметра — целое число от 1 до 1000. Значение по умолчанию равно 1.

Свойства параметров

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PageSize

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр PageSize указывает максимальное число записей на странице. Допустимое значение для этого параметра — целое число от 1 до 1000. Значение по умолчанию — 100.

Свойства параметров

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PolicyName

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

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

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

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PolicyTypes

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр PolicyTypes фильтрует результаты по типу политики угроз, которая помещает сообщение в карантин. Допустимые значения:

  • AntiMalwarePolicy
  • AntiPhishPolicy
  • DataLossPreventionRule
  • ExchangeTransportRule (правило потока обработки почты)
  • HostedContentFilterPolicy (политика защиты от нежелательной почты)
  • SafeAttachmentPolicy (Microsoft Defender только для Office 365)

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

Свойства параметров

Тип:

QuarantinePolicyTypeEnum[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-QuarantineTypes

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр QuarantineTypes фильтрует результаты по тому, что привело к помещению сообщения в карантин. Допустимые значения:

  • Массовая рассылка
  • DataLossPrevention
  • FileTypeBlock (фильтр распространенных вложений в политиках защиты от вредоносных программ во встроенных функциях безопасности для всех облачных почтовых ящиков)
  • HighConfPhish
  • Вредоносные программы (политики защиты от вредоносных программ во встроенных функциях безопасности для всех облачных почтовых ящиков или политики безопасных вложений в Defender для Office 365)
  • Фишинг
  • Спам
  • SPOMalware (Microsoft Defender только для Office 365)
  • TransportRule

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

Этот параметр не требуется использовать с параметром Type.

Для файлов, помещенных в карантин безопасными вложениями для SharePoint, OneDrive и Microsoft Teams, сведения об обнаружении можно найти в поле CustomData в выходных данных.

Свойства параметров

Тип:

QuarantineMessageTypeEnum[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RecipientAddress

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

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

Свойства параметров

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

All
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RecipientTag

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр RecipientTag фильтрует результаты по значению тега пользователя получателя (например, Priority Account). Дополнительные сведения о тегах пользователей см. в разделе Теги пользователей в Defender для Office 365.

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

Свойства параметров

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ReleaseStatus

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр ReleaseStatus фильтрует результаты по состоянию выпуска сообщения. Допустимые значения:

  • Утверждено
  • Denied
  • Error
  • NotReleased
  • PreparingToRelease
  • Выпущено
  • Запрошено

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

Примечание. Сообщения, помещенные в карантин и выпущенные корпорацией Майкрософт из-за проблемы со службой, имеют значение свойства SystemReleased TRUE. Чтобы отфильтровать результаты по системным сообщениям, выполните следующую команду: Get-QuarantineMessage | where {$_.systemreleased -like "True"}.

Свойства параметров

Тип:

ReleaseStatus[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Reported

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

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

  • $true. Команда возвращает только сообщения, помещенные в карантин, которые уже были зарегистрированы как ложноположительные.
  • $false. Команда возвращает только сообщения, помещенные в карантин, которые не были зарегистрированы как ложноположительные.

Свойства параметров

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SenderAddress

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

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

Свойства параметров

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-StartExpiresDate

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

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

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если на компьютере настроен короткий формат даты ММ/дд/гггг, введите 01.09.2018, чтобы указать 1 сентября 2018 г. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".

Например, если указать значение StartExpiresDate для текущей даты и значение EndExpiresDate даты три дня с сегодняшнего дня, вы увидите только сообщения, срок действия которых истекает из карантина в течение следующих трех дней.

Свойства параметров

Тип:System.DateTime
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-StartReceivedDate

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр StartReceivedDate указывает самые ранние сообщения, возвращаемые в результатах. Используйте этот параметр с параметром EndReceivedDate.

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если на компьютере настроен короткий формат даты ММ/дд/гггг, введите 01.09.2018, чтобы указать 1 сентября 2018 г. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".

По умолчанию, если не используются параметры StartReceivedDate и EndReceivedDate, команда возвращает данные за последние 16 дней. Максимальное значение этого параметра — 30 дней. Если вы используете значение старше 30 дней, значение игнорируется и возвращаются только данные за последние 30 дней.

Свойства параметров

Тип:System.DateTime
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Subject

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

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

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-TeamsConversationTypes

Применимо: соответствие требованиям & безопасности

Этот параметр доступен только в PowerShell для обеспечения соответствия требованиям безопасности &.

Параметры TeamsConversationTypes фильтруют результаты по типам бесед Microsoft Teams. Допустимые значения:

  • Канал
  • Чат

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

Свойства параметров

Тип:

Microsoft.Exchange.Management.FfoQuarantine.TeamsConversationType[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Type

Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр Type фильтрует результаты по тому, что привело к помещению сообщения в карантин. Допустимые значения:

  • Массовая рассылка
  • DataLossPrevention
  • HighConfPhish
  • Вредоносная программа
  • Фишинг
  • Спам
  • SPOMalware (Microsoft Defender только для Office 365)
  • TransportRule

Этот параметр не требуется использовать с параметром QuarantineTypes.

Для файлов, защищенных с помощью безопасных вложений для SharePoint, OneDrive и Microsoft Teams, сведения об обнаружении можно найти в поле CustomData в выходных данных.

Свойства параметров

Тип:Microsoft.Exchange.Management.FfoQuarantine.QuarantineMessageTypeEnum
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Summary
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.

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

Input types

Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.

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

Output types

Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.