Release-QuarantineMessage

Ссылка

Модуль:: ExchangePowerShell

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

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

Используйте командлет Release-QuarantineMessage, чтобы убирать сообщения из карантина в облачной организации. Вы можете отправлять сообщения всем исходным получателям или определенным получателям.

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

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

Синтаксис

Release-QuarantineMessage
       -User <String[]>
       [-Identities <QuarantineMessageIdentity[]>]
       [-Identity <QuarantineMessageIdentity>]
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]

Release-QuarantineMessage
       [-Identities <QuarantineMessageIdentity[]>]
       [-Identity <QuarantineMessageIdentity>]
       [-ReleaseToAll]
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]

Release-QuarantineMessage
       -Identities <QuarantineMessageIdentity[]>
       [-Identity <QuarantineMessageIdentity>]
       [-ActionType <ReleaseActionType>]
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]

Release-QuarantineMessage
       -Identity <QuarantineMessageIdentity>
       [-AllowSender]
       [-Confirm]
       [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
       [-Force]
       [-ReportFalsePositive]
       [-WhatIf]
       [<CommonParameters>]

Описание

Рассмотрим следующий сценарий: john@gmail.com отправляет сообщение в faith@contoso.com и john@subsidiary.contoso.com. Gmail разбивает это сообщение на две копии, которые направляются в карантин как фишинг в Майкрософт. Администратор освобождает оба этих сообщения в admin@contoso.com. Доставляется первое выпущенное сообщение, которое попадает в почтовый ящик администратора. Второе выпущенное сообщение определяется как дубликат доставки и пропускается. Сообщения идентифицируются как дубликаты, если они имеют один и тот же идентификатор сообщения и время получения.

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

Примеры

Пример 1

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

В этом примере используется командлет Get-QuarantineMessage для освобождения сообщения в карантине со значением <5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com> Message-ID исходному получателю julia@contoso.com.

Пример 2

Release-QuarantineMessage -Identity c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7 -ReleaseToAll

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

Пример 3

Get-QuarantineMessage | Release-QuarantineMessage -ReleaseToAll

В этом примере все сообщения освобождают всех исходных получателей.

Пример 4

$q = Get-QuarantineMessage -QuarantineTypes SPOMalware

$q[-1] | Release-QuarantineMessage -ReleaseToAll

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

Параметры

-ActionType

Параметр ActionType указывает тип действия выпуска. Допустимые значения:

Запретить
Выпуск. Используйте это значение для выпуска сообщений или утверждения запросов на выпуск сообщений.
Запрос

Тип:	ReleaseActionType
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Online, Security & Compliance, Exchange Online Protection

-AllowSender

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

Если сообщение было помещено в карантин из-за правила транспорта или заблокированного отправителя, сообщения от отправителя могут по-прежнему блокироваться в будущем.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Online, Security & Compliance, Exchange Online Protection

-Confirm

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

Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Online, Security & Compliance, Exchange Online Protection

-EntityType

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

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

Тип:	Microsoft.Exchange.Management.FfoQuarantine.EntityType
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Online, Security & Compliance, Exchange Online Protection

-Force

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

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Online, Security & Compliance, Exchange Online Protection

-Identities

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

Значение удостоверения для сообщения, помещенного в карантин, можно найти с помощью командлета Get-QuarantineMessage.

При использовании этого параметра параметр Identity является обязательным, но значение игнорируется. Например, используйте значение 000 для параметра Identity.

Тип:	QuarantineMessageIdentity[]
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Online, Security & Compliance, Exchange Online Protection

-Identity

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

Значение Identity для сообщения в карантине можно найти с помощью командлета Get-QuarantineMessage.

Тип:	QuarantineMessageIdentity
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False
Применяется к:	Exchange Online, Security & Compliance, Exchange Online Protection

-ReleaseToAll

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

Этот параметр необходим для типа карантина SPOMalware.

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

Использование переключателя ReleaseToAll и параметра User в одной команде недопустимо.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Online, Security & Compliance, Exchange Online Protection

-ReportFalsePositive

Переключатель ReportFalsePositive указывает, следует ли сообщать о сообщении как ложноположительное сообщение в корпорацию Майкрософт (хорошее сообщение помечено как плохое). С этим параметром не нужно указывать значение.

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Online, Security & Compliance, Exchange Online Protection

-User

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

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

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

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Online, Security & Compliance, Exchange Online Protection

-WhatIf

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

Параметр WhatIf не поддерживается в PowerShell безопасности и соответствия требованиям.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Online, Security & Compliance, Exchange Online Protection

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

Input types

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

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

Output types

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

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