Set-DataEncryptionPolicy
此 cmdlet 仅在基于云的服务中可用。
使用 Set-DataEncryptionPolicy cmdlet 修改Exchange Online中的数据加密策略。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Set-DataEncryptionPolicy
[-Identity] <DataEncryptionPolicyIdParameter>
-PermanentDataPurgeReason <String>
[-PermanentDataPurgeContact <String>]
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-Force]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
Set-DataEncryptionPolicy
[-Identity] <DataEncryptionPolicyIdParameter>
-PermanentDataPurgeContact <String>
-PermanentDataPurgeReason <String>
[-PermanentDataPurgeRequested]
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-Force]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
Set-DataEncryptionPolicy
[-Identity] <DataEncryptionPolicyIdParameter>
[-Refresh]
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
说明
您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-DataEncryptionPolicy -Identity "US Mailboxes" -Enabled $false
此示例禁用了名为“美国邮箱”的数据加密策略。
示例 2
Set-DataEncryptionPolicy -Identity "Europe Mailboxes" -Refresh
在 Azure 密钥保管库中轮换其中一个关联的密钥后,此示例将更新名为“欧洲邮箱”的数据加密策略。
参数
-Confirm
适用:Exchange Online、Exchange Online Protection
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false
。 - 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
此 cmdlet 具有内置暂停,因此请使用 -Confirm:$false
跳过确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Description
适用:Exchange Online
Description 参数指定数据加密策略的可选说明。 如果值包含空格,则使用引号括住该值。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DomainController
适用:Exchange Online、Exchange Online Protection
保留此参数以供 Microsoft 内部使用。
类型: | Fqdn |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Enabled
适用:Exchange Online、Exchange Online Protection
Enabled 参数启用或禁用数据加密策略。 有效值包含:
- $true:已启用策略。
- $true:启用此策略。此为默认值。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Force
适用:Exchange Online、Exchange Online Protection
强制开关隐藏警告或确认消息。 不必为此开关指定值。
使用此开关可删除数据加密策略 (PermanentDataPurgeRequested 交换机) 加密的所有数据,但关联的 Azure 密钥保管库也已删除。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Identity
适用:Exchange Online
Identity 参数指定要修改的数据加密策略。 可以使用任何能够唯一标识该策略的值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
类型: | DataEncryptionPolicyIdParameter |
Position: | 1 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-Name
适用:Exchange Online
Name 参数指定数据加密策略的唯一名称。 如果值包含空格,则使用引号括住该值。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-PermanentDataPurgeContact
适用:Exchange Online、Exchange Online Protection
PermanentDataPurgeContact 参数指定一个联系人,用于清除数据加密策略加密的所有数据。 如果值包含空格,则使用引号括住该值。
需要将此参数与 PermanentDataPurgeRequested 和 PermanentDataPurgeReason 参数一起使用。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-PermanentDataPurgeReason
适用:Exchange Online、Exchange Online Protection
PermanentDataPurgeReason 参数指定清除数据加密策略加密的所有数据的描述性原因。 如果值包含空格,则使用引号括住该值。
需要将此参数与 PermanentDataPurgeRequested 和 PermanentDataPurgeContact 参数一起使用。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-PermanentDataPurgeRequested
适用:Exchange Online、Exchange Online Protection
PermanentDataPurgeRequested 开关指定是否启动删除由数据加密策略加密的所有数据。 不必为此开关指定值。
需要将此开关与 PermanentDataPurgeReason 和 PermanentDataPurgeContact 参数一起使用。
使用此开关后,无法将数据加密策略分配给其他邮箱。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Refresh
适用:Exchange Online
在轮换 Azure 密钥保管库中的任何关联密钥后,使用“刷新”开关更新 Exchange Online 中的数据加密策略。 不必为此开关指定值。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
适用:Exchange Online、Exchange Online Protection
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |