Release-QuarantineMessage

此指令程式只能在雲端式服務中使用。

使用 Release-QuarantineMessage Cmdlet 釋出您的雲端型組織中隔離的郵件。 您可以將郵件發佈給所有原始收件者,或特定收件者。

針對已由 SharePoint、OneDrive 和 Microsoft Teams 的安全附件隔離的檔案,您可以使用 Release-QuarantineMessage Cmdlet 解除封鎖各個小組網站和文件庫中的檔案,讓使用者可以存取、共用和下載檔案。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。

語法

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>]

Description

請試想下列案例: john@gmail.com 傳送郵件至 faith@contoso.comjohn@subsidiary.contoso.com和 。 Gmail 會將此郵件分成兩個複本,它們都會被當成網路釣魚路由到 Microsoft 中的隔離區。 系統管理員會將這兩則訊息釋放至 admin@contoso.com。 到達系統管理員信箱的第一封已發行郵件隨即送達。 第二個發行的訊息被識別為重複傳遞,並略過。 如果訊息具有相同的訊息 ID 和接收時間,則這些訊息會識別為重複。

您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 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、安全性 & 合規性、內部部署信箱的內建安全性附加元件

ActionType 參數會指定發行動作類型。 有效值為:

  • Deny
  • 發行:使用此值來釋放訊息或核准釋放訊息的要求。
  • 要求

參數屬性

類型:ReleaseActionType
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-AllowSender

適用項目:Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

AllowSender 參數會指定不會隔離來自寄件者的所有未來郵件。 您不需要使用此參數指定值。

如果郵件由於傳輸規則或封鎖的寄件者而被隔離,則來自該寄件者的後續郵件仍可能被封鎖。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

適用項目:Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

Confirm 參數會指定要顯示或隱藏確認提示。 此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。

  • 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停,它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:-Confirm:$false。
  • 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet,指定不帶值的 Confirm 參數會造成暫停,強制您在繼續之前先確認命令。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:CF

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Force

適用項目:Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

強制開關會隱藏警告或確認訊息。 您不需要使用此參數指定值。

每當您嘗試從隔離區重新發行先前發行的郵件時,請使用此參數。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示: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 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、安全性 & 合規性、內部部署信箱的內建安全性附加元件

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、安全性 & 合規性、內部部署信箱的內建安全性附加元件

ReleaseToAll 參數會將隔離的郵件釋出給所有原始收件者。 您不需要使用此參數指定值。

隔離類型 SPOMalware 需要此參數。

如果您先前使用 User 參數或 ReleaseToAll 參數將隔離的郵件釋放給部分或所有的原始收件者,當您再次使用 ReleaseToAll 參數時,會略過這些收件者。

您不能在相同的命令中使用 ReleaseToAll 參數和 User 參數。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

OrgReleaseToAll
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ReportFalsePositive

適用項目:Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

ReportFalsePositive 參數可指定是否要將訊息回報為誤判,以Microsoft標示為錯誤) (好訊息。 您不需要使用此參數指定值。

此參數僅適用於隔離的垃圾郵件。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-User

適用項目:Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

User 參數會指定隔離訊息釋放對象的使用者電子郵件地址。 您可以指定以逗號隔開的多個電子郵件地址。

您可以使用這個參數,將郵件釋出給原始郵件的收件者,或組織中的任何其他電子郵件地址。

如果您曾使用 ReleaseToAll 參數將隔離的郵件釋出給原始收件者中的所有收件者,且您稍後再次使用 User 參數釋出郵件,所有使用 User 參數會指定的原始收件者均會略過。

參數屬性

類型:

String[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

OrgReleaseToUser
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

WhatIf 開關無法在安全性與合規性 PowerShell 中使用。

WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:WI

參數集

(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

若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。