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 указывает тип действия выпуска. Допустимые значения:

"Утвердить"
"Запретить"
Выпуск
Запрос

Type:	ReleaseActionType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-AllowSender

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Confirm

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

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-EntityType

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

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

Type:	Microsoft.Exchange.Management.FfoQuarantine.EntityType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Force

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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.

Type:	QuarantineMessageIdentity[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Identity

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

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

Type:	QuarantineMessageIdentity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ReleaseToAll

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

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

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ReportFalsePositive

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-User

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

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

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

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-WhatIf

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

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

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

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

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

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.