Set-QuarantinePermissions
此指令程式只能在雲端式服務中使用。
使用 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 命令中使用 $Perms
EndUserQuarantinePermissions參數值。
參數
-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 |