Set-QuarantinePermissions
此指令程式只能在雲端式服務中使用。
注意:我們建議不要使用此 cmdlet 來設定隔離政策權限,而是在 New-QuarantinePolicy 和 Set-QuarantinePolicy cmdlet 上使用 EndUserQuarantinePermissionsValue 參數。
使用 Set-QuarantinePermissions 指令小程式修改由 New-QuarantinePermissions 建立並以變數形式儲存在目前 PowerShell 會話中的隔離權限物件。 你可以用這個變數作為 EndUserQuarantinePermissions 參數的值,無論是在 New-QuarantinePolicy 或同一個 PowerShell 會話裡的 Set-QuarantinePolicy 個 cmdlet。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Set-QuarantinePermissions
-QuarantinePermissionsObject <QuarantinePermissions>
[[-PermissionToAllowSender] <Boolean>]
[[-PermissionToBlockSender] <Boolean>]
[[-PermissionToDelete] <Boolean>]
[[-PermissionToDownload] <Boolean>]
[[-PermissionToPreview] <Boolean>]
[[-PermissionToRelease] <Boolean>]
[[-PermissionToRequestRelease] <Boolean>]
[[-PermissionToViewHeader] <Boolean>]
[<CommonParameters>]
Description
要查看你想修改的權限物件目前值,請以指令執行變數名稱。 例如,執行 $Perms 指令查看儲存在變數中的 $Perms 隔離政策權限。
您必須已獲指派權限,才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數,但如果某些參數未包含在你分配的權限中,你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-QuarantinePermissions -QuarantinePermissionsObject $Perms -PermissionToRequestRelease $true -PermissionToRelease $false
此範例修改了先前在同一 PowerShell 會話中用 New-QuarantinePermissions cmdlet 建立的退出 $Perms 變數中的隔離政策權限, ($Perms 該變數仍可用且已填充) 。
在同一個 PowerShell 會話中,你可以用 $PermsEndUserQuarantinePermissions 參數值來設定 New-QuarantinePolicy 或 Set-QuarantinePolicy 指令。
參數
-PermissionToAllowSender
適用:Exchange Online,內建本地信箱安全外掛
PermissionToBlockSender 參數指定使用者是否被允許將隔離的訊息發送者加入其安全寄件人清單。 有效值為:
- $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 |
-QuarantinePermissionsObject
適用:Exchange Online,內建本地信箱安全外掛
QuarantinePermissionsObject 參數指定你想修改的現有變數,包含隔離權限。 例如,如果你之前執行過這個指令 $Perms = New-QuarantinePermissions <permissions>,請使用這個參數的值 $Perms 。
參數屬性
| 類型: | QuarantinePermissions |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 9 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。