New-QuarantinePermissions
此指令程式只能在雲端式服務中使用。
使用 New-QuarantinePermissions Cmdlet 來建立隔離權限物件,以搭配 New-QuarantineTag Cmdlet 使用。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
Syntax
New-QuarantinePermissions
[-PermissionToBlockSender <Boolean>]
[-PermissionToDelete <Boolean>]
[-PermissionToDownload <Boolean>]
[-PermissionToPreview <Boolean>]
[-PermissionToRelease <Boolean>]
[-PermissionToRequestRelease <Boolean>]
[-PermissionToViewHeader <Boolean>]
[<CommonParameters>]
Description
您未使用之任何參數的預設值是$false,因此您只需要使用參數 (您想要設定為$true的許可權) 。
您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
$NoAccess = New-QuarantinePermissions
此範例會建立安全 & 性合規性中隔離標籤中[無存取權限] 群組所使用的相同許可權。 permissions 物件會儲存在名為 的 $NoAccess
變數中。
在相同的Windows PowerShell會話中,您可以在 New-QuarantineTag 或 Set-QuarantineTag 命令中使用 $NoAccess
EndUserQuarantinePermissions參數值。
範例 2
$LimitedAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRequestRelease $true
此範例會建立安全性合規性中隔離標籤 & 中有限存取權限群組所使用的相同許可權。 permissions 物件會儲存在名為 的 $LimitedAccess
變數中。
在相同的Windows PowerShell會話中,您可以在 New-QuarantineTag 或 Set-QuarantineTag 命令中使用 $LimitedAccess
EndUserQuarantinePermissions參數值。
範例 3
$FullAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRelease $true
此範例會建立安全性合規性中隔離標籤 & 中完整存取權限群組所使用的相同許可權。 permissions 物件會儲存在名為 的 $FullAccess
變數中。
在相同的Windows PowerShell會話中,您可以在 New-QuarantineTag 或 Set-QuarantineTag 命令中使用 $FullAccess
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 |