Release-QuarantineMessage

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

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

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

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

语法

OrgReleaseToUser

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

OrgReleaseToAll

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

Identities

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

IdentityOnly

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

适用:Exchange Online、安全 & 合规性、Exchange Online Protection

ActionType 参数指定发布作类型。 有效值包含:

  • 拒绝
  • 发布:使用此值发布消息或批准发布消息的请求。
  • 请求

参数属性

类型:ReleaseActionType
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AllowSender

适用:Exchange Online、安全 & 合规性、Exchange Online Protection

AllowSender 开关指定不会隔离来自发件人的所有未来邮件。 不必为此开关指定值。

如果邮件是因为传输规则或黑名单而被隔离,那么今后将继续拦截此发件人发送的邮件。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

适用:Exchange Online、安全 & 合规性、Exchange Online Protection

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

  • 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EntityType

适用:Exchange Online、安全 & 合规性、Exchange Online Protection

EntityType 参数按 EntityType 筛选结果。 有效值包含:

  • 电子邮件
  • SharePointOnline
  • Teams (当前为预览版)
  • DataLossPrevention

参数属性

类型:Microsoft.Exchange.Management.FfoQuarantine.EntityType
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Force

适用:Exchange Online、安全 & 合规性、Exchange Online Protection

强制开关隐藏警告或确认消息。 不必为此开关指定值。

每当尝试从隔离区中重新释放以前发布的邮件时,都使用此开关。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Identities

适用:Exchange Online、安全 & 合规性、Exchange Online Protection

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

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

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

参数属性

类型:

QuarantineMessageIdentity[]

默认值:None
支持通配符:False
不显示: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、安全 & 合规性、Exchange Online Protection

Identity 参数指定要释放的已隔离邮件。 值是格式 GUID1\GUID2 的唯一隔离邮件标识符, (例如 c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7) 。

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

参数属性

类型:QuarantineMessageIdentity
默认值:None
支持通配符:False
不显示: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、安全 & 合规性、Exchange Online Protection

ReleaseToAll 开关将隔离邮件释放到所有原始收件人。 不必为此开关指定值。

隔离类型 SPOMalware 需要此开关。

如果以前使用 User 参数或 ReleaseToAll 开关将隔离邮件释放给部分或所有原始收件人,则再次使用 ReleaseToAll 开关时将跳过这些收件人。

不能在同一个命令中同时使用 ReleaseToAll 开关和 User 参数。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

OrgReleaseToAll
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ReportFalsePositive

适用:Exchange Online、安全 & 合规性、Exchange Online Protection

ReportFalsePositive 开关指定是否将邮件报告为误报给Microsoft (标记为坏) 。 不必为此开关指定值。

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-User

适用:Exchange Online、安全 & 合规性、Exchange Online Protection

User 参数指定要向其释放隔离邮件的用户的电子邮件地址。 可以指定多个电子邮件地址,中间用逗号分隔。

可以使用此参数将邮件释放给原始邮件的收件人,或发布到组织中的任何其他电子邮件地址。

如果之前使用 ReleaseToAll 开关将隔离邮件释放到所有原始收件人,且之后又使用 User 参数再次释放邮件,则将跳过使用 User 参数指定的所有原始收件人。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

OrgReleaseToUser
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

适用:Exchange Online、安全 & 合规性、Exchange Online Protection

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

WhatIf 开关在安全与合规 PowerShell 中不起作用。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

Input types

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

输出

Output types

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