New-QuarantinePermissions
此指令程式只能在雲端式服務中使用。
注意:我們建議不要使用此 cmdlet 來設定隔離政策權限,而是在 New-QuarantinePolicy 和 Set-QuarantinePolicy cmdlet 上使用 EndUserQuarantinePermissionsValue 參數。
使用 New-QuarantinePermissions cmdlet 建立一個包含隔離權限物件的變數,該物件可搭配 EndUserQuarantinePermissions 參數在 New-QuarantinePolicy 或同一 PowerShell 會話中使用 Set-QuarantinePolicy 個 cmdlet。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
New-QuarantinePermissions
[[-PermissionToAllowSender] <Boolean>]
[[-PermissionToBlockSender] <Boolean>]
[[-PermissionToDelete] <Boolean>]
[[-PermissionToDownload] <Boolean>]
[[-PermissionToPreview] <Boolean>]
[[-PermissionToRelease] <Boolean>]
[[-PermissionToRequestRelease] <Boolean>]
[[-PermissionToViewHeader] <Boolean>]
[<CommonParameters>]
Description
你不用的參數預設值是 $false,所以你只需要用你想設為$true的參數 (權限) 。
您必須已獲指派權限,才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數,但如果某些參數未包含在你分配的權限中,你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
$NoAccess = New-QuarantinePermissions
此範例建立與隔離政策中「無存取權限」群組相同的權限。 權限物件儲存在名為 $NoAccess的變數中。
在同一個 PowerShell 會話中,你可以用 $NoAccessEndUserQuarantinePermissions 參數值來設定 New-QuarantinePolicy 或 Set-QuarantinePolicy 指令。
範例 2
$LimitedAccess = New-QuarantinePermissions -PermissionToAllowSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRequestRelease $true
此範例建立與隔離政策中有限存取權限群組相同的權限。 權限物件儲存在名為 $LimitedAccess的變數中。
在同一個 PowerShell 會話中,你可以用 $LimitedAccessEndUserQuarantinePermissions 參數值來設定 New-QuarantinePolicy 或 Set-QuarantinePolicy 指令。
範例 3
$FullAccess = New-QuarantinePermissions -PermissionToAllowSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRelease $true
此範例建立與隔離政策中完全存取權限群組相同的權限。 權限物件儲存在名為 $FullAccess的變數中。
在同一個 PowerShell 會話中,你可以用 $FullAccessEndUserQuarantinePermissions 參數值來設定 New-QuarantinePolicy 或 Set-QuarantinePolicy 指令。
參數
-PermissionToAllowSender
適用:Exchange Online,內建本地信箱安全外掛
PermissionToAllowSender 參數指定使用者是否被允許將隔離的訊息發送者加入其安全寄件人清單。 有效值為:
- $true:隔離中受影響的訊息可用允許發送者。
- $false:隔離期間受影響的訊息無法使用允許發送者。 這個值是預設值。
參數屬性
| 類型: | Boolean |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PermissionToBlockSender
適用:Exchange Online,內建本地信箱安全外掛
PermissionToBlockSender 參數指定使用者是否被允許將隔離的訊息發送者加入其被封鎖的寄件人清單。 有效值為:
- $true:封鎖發送者可用於受影響郵件的隔離通知,封鎖發送者則適用於隔離中的受影響郵件。
- $false:封鎖發送者無法出現在受影響訊息的隔離通知中,且隔離期間受影響的訊息也無法使用封鎖發送者。 這個值是預設值。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 2 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PermissionToDelete
適用:Exchange Online,內建本地信箱安全外掛
PermissionToDelete 參數指定使用者是否被允許刪除隔離區的訊息。 有效值為:
- $true:隔離中受影響的訊息可以使用刪除訊息和從隔離中刪除。
- $false:隔離期間受影響的訊息無法使用刪除訊息和從隔離中刪除。 這個值是預設值。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 3 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PermissionToDownload
適用:Exchange Online,內建本地信箱安全外掛
PermissionToDownload 參數指定使用者是否被允許從隔離區下載訊息。 有效值為:
- $true:權限已啟用。
- $false:權限已停用。 這個值是預設值。
目前,此值不影響隔離通知或受影響訊息隔離中的可用行動。 終端使用者無法下載隔離訊息。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 4 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PermissionToPreview
適用:Exchange Online,內建本地信箱安全外掛
PermissionToPreview 參數指定使用者是否被允許預覽隔離訊息。 有效值為:
- $true:隔離期間受影響的訊息可預覽。
- $false:隔離期間受影響的訊息無法預覽。 這個值是預設值。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 5 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PermissionToRelease
適用:Exchange Online,內建本地信箱安全外掛
PermissionToRelease 參數指定使用者是否被允許直接解除隔離中受影響的訊息。 有效值為:
- $true:釋放通知可在受影響訊息的隔離通知中取得,隔離訊息中 (釋放郵件) 則可查詢受影響郵件。
- $false:受影響郵件的隔離通知中無法提供釋放訊息,隔離期間受影響的郵件也無法收到釋放與釋放郵件。
不要把這個參數和 PermissionToRequestRelease 參數設為 $true。 將其中一個參數設為$true,另一個設為$false,或兩個參數都設為$false。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 6 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PermissionToRequestRelease
適用:Exchange Online,內建本地信箱安全外掛
PermissionToRequestRelease 參數指定使用者是否被允許請求解除隔離狀態。 申請必須經管理員批准。有效的數值如下:
- $true:申請釋放可在隔離通知中取得受影響訊息,申請釋放則適用於隔離中受影響的訊息。
- $false:在隔離通知中無法提供「請求釋放」功能,且在隔離期間受影響的訊息中也無法提供「請求釋放」。
不要把這個參數和 PermissionRelease 參數設為 $true。 將其中一個參數設為$true,另一個設為$false,或兩個參數都設為$false。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 7 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PermissionToViewHeader
適用:Exchange Online,內建本地信箱安全外掛
PermissionToViewHeader 參數指定使用者是否被允許查看隔離訊息的訊息標頭。 有效值為:
- $true:權限已啟用。
- $false:權限已停用。 這個值是預設值。
目前,此值不影響隔離通知或受影響訊息隔離中的可用行動。 在隔離期間,受影響訊息的標頭功能始終可用。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 8 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。