通过

Release-QuarantineMessage

  • 参考
模块:
ExchangePowerShell
适用于:
Exchange Online, Security & Compliance, Exchange Online Protection

此 cmdlet 仅在基于云的服务中可用。

使用 Release-QuarantineMessage cmdlet 释放基于云的组织中隔离的邮件。 可以向所有原始收件人或特定收件人发布邮件。

对于由 SharePoint、OneDrive 和 Microsoft Teams 的安全附件隔离的文件，可以使用 Release-QuarantineMessage cmdlet 取消阻止相应团队网站和文档库中的文件，以便用户可以访问、共享和下载文件。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

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 将此邮件分为两个副本，这些副本都作为 Microsoft 中的网络钓鱼路由到隔离区。 管理员将这两条消息发布到 admin@contoso.com。 将传递到达管理员邮箱的第一封已发布邮件。 第二个已发布的消息被标识为重复传递，并被跳过。 如果消息 ID 和接收时间相同，则消息被标识为重复项。

您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 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 cmdlet 将具有 Message-ID 值的 <5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com> 隔离邮件释放给原始收件人 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

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
  • 大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet，指定不含值的 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

Identities 参数标识批量操作的隔离邮件。 使用语法标识消息： value1,value2,...valueN。 值是格式 GUID1\GUID2 的唯一隔离邮件标识符， (例如 c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7) 。

可以使用 Get-QuarantineMessage cmdlet 查找隔离邮件的标识值。

使用此参数时，需要 Identity 参数，但忽略该值。 例如，对 Identity 参数使用值 000。

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) 。

可以使用 Get-QuarantineMessage cmdlet 查找已隔离邮件的 Identity 值。

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 开关指定是否将邮件报告为误报给 Microsoft (标记为坏) 的好消息。 不必为此开关指定值。

此开关仅适用于隔离的垃圾邮件。

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

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。