Set-QuarantinePermissions

模組:

ExchangePowerShell

適用於:

Exchange Online, Exchange Online Protection

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

使用 Set-QuarantinePermissions Cmdlet 來修改隔離 (New-QuarantineTag或Set-QuarantineTag Cmdlet) 之隔離標籤中使用的隔離權限物件。 此 Cmdlet 僅適用于New-QuarantinePermissions Cmdlet 所建立並儲存在目前可在Windows PowerShell會話中使用的變數中的權限物件。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Set-QuarantinePermissions
   -QuarantinePermissionsObject <QuarantinePermissions>
   [-PermissionToBlockSender <Boolean>]
   [-PermissionToDelete <Boolean>]
   [-PermissionToDownload <Boolean>]
   [-PermissionToPreview <Boolean>]
   [-PermissionToRelease <Boolean>]
   [-PermissionToRequestRelease <Boolean>]
   [-PermissionToViewHeader <Boolean>]
   [<CommonParameters>]

Description

若要查看您想要修改之 permissions 物件的目前值，請以命令執行變數名稱。 例如，執行 命令 $Perms 以查看儲存在變數中的 $Perms 隔離標籤許可權。

您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Set-QuarantinePermissions -QuarantinePermissionsObject $Perms -PermissionToRequestRelease $true -PermissionToRelease $false

本範例會修改先前在相同Windows PowerShell會話中建立的結束 $Perms 權限物件中指定的隔離標籤許可權， ($Perms 變數仍可使用且填入) 。

在相同的Windows PowerShell會話中，您可以在 New-QuarantineTag 或 Set-QuarantineTag 命令中使用 $PermsEndUserQuarantinePermissions參數值。

參數

-PermissionToBlockSender

PermissionToBlockSender 參數會指定是否允許使用者將隔離的郵件寄件者新增至其封鎖的寄件者清單。 有效值為：

• $true：[封鎖寄件者] 按鈕包含在使用者隔離通知中。
• $false：[封鎖寄件者] 按鈕不包含在使用者隔離通知中。 這是預設值。

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

-PermissionToDelete

PermissionToDelete 參數會指定是否允許使用者從隔離區刪除郵件。 有效值為：

• $true：隔離郵件詳細資料中包含 [從隔離中移除] 按鈕。
• $false：隔離郵件詳細資料中未包含 [從隔離中移除] 按鈕。 這是預設值。

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

-PermissionToDownload

PermissionToDownload 參數會指定是否允許使用者從隔離區下載訊息。 有效值為：

• $true：已啟用許可權。
• $false：已停用許可權。 這是預設值。

目前，此值不會影響使用者垃圾郵件通知或隔離郵件詳細資料中包含的按鈕。

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

-PermissionToPreview

PermissionToPreview 參數會指定是否允許使用者預覽隔離的郵件。 有效值為：

• $true：[預覽] 訊息按鈕包含在隔離的郵件詳細資料中。
• $false：[預覽] 訊息按鈕不包含在隔離的郵件詳細資料中。 這是預設值。

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

-PermissionToRelease

PermissionToRelease 參數會指定是否允許使用者直接從隔離區釋放訊息。 有效值為：

• $true：[發行] 按鈕包含在使用者垃圾郵件通知中，而 [發行訊息] 按鈕會包含在隔離的郵件詳細資料中。
• $false：[發行] 按鈕不包含在使用者垃圾郵件通知中，且 [發行訊息] 按鈕未包含在隔離的郵件詳細資料中。 這是預設值。

請勿將此參數和 PermissionToRequestRelease 參數設定為 $true。 將一個參數設定為 $true，另一個參數設定為 $false，或將兩個參數設定為 $false。

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

-PermissionToRequestRelease

PermissionToRequestRelease 參數會指定是否允許使用者要求從隔離區釋放訊息。 要求必須由系統管理員核准。有效值為：

• $true：[發行] 按鈕包含在使用者垃圾郵件通知中，而 [發行訊息] 按鈕會包含在隔離的郵件詳細資料中。
• $false：[發行] 按鈕不包含在使用者垃圾郵件通知中，且 [發行訊息] 按鈕未包含在隔離的郵件詳細資料中。 這是預設值。

請勿將此參數和 PermissionRelease 參數設定為 $true。 將一個參數設定為 $true，另一個參數設定為 $false，或將兩個參數設定為 $false。

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

-PermissionToViewHeader

PermissionToViewHeader 參數會指定是否允許使用者檢視隔離郵件的郵件標頭。 有效值為：

• $true：已啟用許可權。
• $false：已停用許可權。 這是預設值。

目前，此值不會影響使用者垃圾郵件通知或隔離郵件詳細資料中包含的按鈕。 [檢視郵件標題] 按鈕一律可在隔離的郵件詳細資料中取得。

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

-QuarantinePermissionsObject

QuarantinePermissionsObject 參數會指定包含您要修改之隔離權限物件的變數。 例如，如果您執行 命令 $Perms = New-QuarantinePermissions <permissions> ，請使用這個參數的值 $Perms 。

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