Set-DataEncryptionPolicy

模組:

Exchange PowerShell

此指令程式只能在雲端式服務中使用。

使用 Set-DataEncryptionPolicy Cmdlet 修改 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>]

ReplaceKey

Set-DataEncryptionPolicy
    [-Identity] <DataEncryptionPolicyIdParameter>
    -AzureKeyIDs <MultiValuedProperty>
    -Replace
    [-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 的資料加密原則。

參數

-AzureKeyIDs

適用：Exchange Online

{{ Fill AzureKeyIDs 描述 }}

參數屬性

類型:	MultiValuedProperty
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ReplaceKey

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

適用：Exchange Online、內部部署信箱的內建安全性附加元件

Confirm 參數會指定要顯示或隱藏確認提示。 此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。

• 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
• 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet，指定不帶值的 Confirm 參數會造成暫停，強制您在繼續之前先確認命令。

此 Cmdlet 具有內建的暫停，因此請使用 -Confirm:$false 來略過確認。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	CF

參數集

(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、內部部署信箱的內建安全性附加元件

強制開關會隱藏警告或確認訊息。 您不需要使用此參數指定值。

使用此參數可刪除資料加密原則 (PermanentDataPurgeRequested 參數) 加密的所有資料，但相關聯的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

Name 參數會指定資料加密原則的唯一名稱。 如果值包含空格，請使用引號括住值。

參數屬性

類型:	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、內部部署信箱的內建安全性附加元件

PermanentDataPurgeRequested 參數會指定是否要起始刪除資料加密原則所加密的所有資料。 您不需要使用此參數指定值。

您必須將此參數與 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

-Replace

適用：Exchange Online

{{ 填滿取代描述 }}

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ReplaceKey

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

適用：Exchange Online、內部部署信箱的內建安全性附加元件

WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	WI

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。