Release-QuarantineMessage
Этот командлет доступен только в облачной службе.
Используйте командлет Release-QuarantineMessage, чтобы убирать сообщения из карантина в облачной организации. Вы можете отправить сообщения всем исходным получателям или определенным получателям.
Файлы, помещенные в карантин безопасными вложениями для SharePoint, OneDrive и Microsoft Teams, можно разблокировать на соответствующих сайтах групп и в библиотеках документов с помощью командлета Release-QuarantineMessage, чтобы пользователи могли получать доступ к файлам, делиться ими и скачивать их.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
OrgReleaseToUser
Release-QuarantineMessage
-User <String[]>
[-Identities <QuarantineMessageIdentity[]>]
[-Identity <QuarantineMessageIdentity>]
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
OrgReleaseToAll
Release-QuarantineMessage
[-Identities <QuarantineMessageIdentity[]>]
[-Identity <QuarantineMessageIdentity>]
[-ReleaseToAll]
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
Identities
Release-QuarantineMessage
-Identities <QuarantineMessageIdentity[]>
[-Identity <QuarantineMessageIdentity>]
[-ActionType <ReleaseActionType>]
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
IdentityOnly
Release-QuarantineMessage
-Identity <QuarantineMessageIdentity>
[-AllowSender]
[-Confirm]
[-Force]
[-ReportFalsePositive]
[-WhatIf]
[<CommonParameters>]
Описание
Рассмотрим следующий сценарий: john@gmail.com отправляет сообщение и faith@contoso.comjohn@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
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр ActionType определяет тип действия выпуска. Допустимые значения:
- Запретить
- Освобождение: используйте это значение для освобождения сообщений или утверждения запросов на освобождение сообщений.
- Запрос
Свойства параметров
| Тип: | ReleaseActionType |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AllowSender
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Ключ AllowSender указывает, что все последующие сообщения от отправителя не помещаются в карантин. С этим параметром не нужно указывать значение.
Если сообщение было помещено в карантин из-за правила транспорта или заблокированного отправителя, сообщения от отправителя могут по-прежнему блокироваться в будущем.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Используйте этот переключатель при попытке повторно освободить ранее освобожденные сообщения из карантина.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identities
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр Identities определяет сообщения, помещенные в карантин, для массовых операций. Вы идентифицируете сообщения с помощью следующего синтаксиса: value1,value2,...valueN. Значение является уникальным идентификатором сообщения, помещенного в карантин, в формате GUID1\GUID2 (например c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7, ).
Значение идентификатора сообщения, помещенного в карантин, можно найти с помощью командлета Get-QuarantineMessage.
При использовании этого параметра параметр Identity является обязательным, но значение игнорируется. Например, используйте значение 000 в качестве параметра Identity.
Свойства параметров
| Тип: | QuarantineMessageIdentity[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identities
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
OrgReleaseToAll
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
OrgReleaseToUser
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр Identity указывает сообщение, которое необходимо переместить из карантина. Значение является уникальным идентификатором сообщения, помещенного в карантин, в формате GUID1\GUID2 (например c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7, ).
Значение Identity для сообщения в карантине можно найти с помощью командлета Get-QuarantineMessage.
Свойства параметров
| Тип: | QuarantineMessageIdentity |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identities
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
OrgReleaseToAll
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
OrgReleaseToUser
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
IdentityOnly
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ReleaseToAll
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Переключатель ReleaseToAll снимает сообщение с карантина для всех исходных получателей. С этим параметром не нужно указывать значение.
Этот параметр необходим для типа карантина SPOMalware.
Если ранее вы использовали параметр User или переключатель ReleaseToAll, чтобы освободить сообщение в карантине для некоторых или всех исходных получателей, эти получатели будут пропущены при повторном использовании переключателя ReleaseToAll.
Использование переключателя ReleaseToAll и параметра User в одной команде недопустимо.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
OrgReleaseToAll
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ReportFalsePositive
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр ReportFalsePositive указывает, следует ли сообщать корпорации Майкрософт о ложноположительном результате (хорошее сообщение помечено как плохое). С этим параметром не нужно указывать значение.
Этот переключатель доступен только для спам-сообщений, помещенных в карантин.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-User
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр User указывает электронный адрес пользователя, для которого следует снять сообщение с карантина. Можно указать несколько адресов электронной почты, разделив их запятыми.
С помощью этого параметра можно отправить сообщение получателям исходного сообщения или другим адресам электронной почты в организации.
Если ранее для того, чтобы снять сообщение с карантина для всех исходных пользователей, вы использовали параметр ReleaseToAll, а затем вновь сделали это при помощи параметра User, все исходные получатели, указанные с помощью User, пропускаются.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
OrgReleaseToUser
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Параметр WhatIf не поддерживается в PowerShell безопасности и соответствия требованиям.
Переключатель WhatIf показывает, что команда делает без каких-либо изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| 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
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.