Set-DataEncryptionPolicy
此指令程式只能在雲端式服務中使用。
使用 Set-DataEncryptionPolicy 指令碼來修改 Exchange Online 的資料加密政策。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
DCAdminPurgeKeyRequest
Set-DataEncryptionPolicy
[-Identity] <DataEncryptionPolicyIdParameter>
-PermanentDataPurgeReason <String>
[-PermanentDataPurgeContact <String>]
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-Force]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
TenantAdminPurgeKeyRequest
Set-DataEncryptionPolicy
[-Identity] <DataEncryptionPolicyIdParameter>
-PermanentDataPurgeContact <String>
-PermanentDataPurgeReason <String>
[-PermanentDataPurgeRequested]
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-Force]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
RefreshKey
Set-DataEncryptionPolicy
[-Identity] <DataEncryptionPolicyIdParameter>
[-Refresh]
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
Description
您必須已獲指派權限,才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數,但如果某些參數未包含在你分配的權限中,你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-DataEncryptionPolicy -Identity "US Mailboxes" -Enabled $false
此範例停用了名為 US Mailboxes 的資料加密政策。
範例 2
Set-DataEncryptionPolicy -Identity "Europe Mailboxes" -Refresh
此範例在Azure 金鑰保存庫中輪換其中一個相關金鑰後,更新名為 Europe Mailboxes 的資料加密政策。
參數
-Confirm
適用:Exchange Online,內建本地信箱安全外掛
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停,它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
這個指令檔內建暫停,請跳 -Confirm:$false 過確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 參見 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Description
適用:Exchange Online
Description 參數指定了資料加密政策的可選描述。 如果值包含空格,請使用引號括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainController
適用:Exchange Online,內建本地信箱安全外掛
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Enabled
適用:Exchange Online,內建本地信箱安全外掛
Enabled 參數用來啟用或停用資料加密政策。 有效值為:
- $true:政策已啟用。
- $true:已啟用原則。此為預設值。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
適用:Exchange Online,內建本地信箱安全外掛
力場開關會隱藏警告或確認訊息。 您不需要使用此參數指定值。
用這個交換器刪除所有被 PermanentDataPurgeRequest) ed 交換器 (資料加密政策加密的資料,但相關的Azure 金鑰保存庫也被刪除了。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TenantAdminPurgeKeyRequest
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
DCAdminPurgeKeyRequest
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用:Exchange Online
Identity 參數指定你想修改的資料加密政策。 您可以使用唯一識別原則的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
參數屬性
| 類型: | DataEncryptionPolicyIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Name
適用:Exchange Online
名稱參數指定資料加密政策的唯一名稱。 如果值包含空格,請使用引號括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PermanentDataPurgeContact
適用:Exchange Online,內建本地信箱安全外掛
PermanentDataPurgeContact 參數指定一個聯絡人,負責清除所有被資料加密政策加密的資料。 如果值包含空格,請使用引號括住值。
你需要用這個參數搭配 PermanentDataPurgeRequested 和 PermanentDataPurgeReason 參數。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TenantAdminPurgeKeyRequest
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
DCAdminPurgeKeyRequest
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PermanentDataPurgeReason
適用:Exchange Online,內建本地信箱安全外掛
PermanentDataPurgeReason 參數指定了一個描述性理由,說明清除所有被資料加密政策加密的資料。 如果值包含空格,請使用引號括住值。
你需要將此參數搭配 PermanentDataPurgeRequested 和 PermanentDataPurgeContact 參數使用。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TenantAdminPurgeKeyRequest
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
DCAdminPurgeKeyRequest
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PermanentDataPurgeRequested
適用:Exchange Online,內建本地信箱安全外掛
永久資料清除請求交換器會指定是否要啟動刪除所有被資料加密政策加密的資料。 您不需要使用此參數指定值。
你需要用這個交換器搭配 PermanentDataPurgeReason 和 PermanentDataPurgeContact 參數。
使用這個交換器後,你無法將資料加密政策指派給其他信箱。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
TenantAdminPurgeKeyRequest
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Refresh
適用:Exchange Online
在Azure 金鑰保存庫中輪換任何相關的金鑰後,使用刷新開關更新資料加密政策Exchange Online。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
RefreshKey
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用:Exchange Online,內建本地信箱安全外掛
WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 威斯康辛 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。