Set-DataEncryptionPolicy

模块:

ExchangePowerShell

适用于:

Exchange Online, Exchange Online Protection

此 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

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

• 破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
• 大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Description

Description 参数指定数据加密策略的可选说明。 如果值包含空格，则使用引号括住该值。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-DomainController

保留此参数以供 Microsoft 内部使用。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Enabled

Enabled 参数启用或禁用数据加密策略。 有效值包含:

• $true：策略已启用。
• $true：启用此策略。此为默认值。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Force

强制开关隐藏警告或确认消息。 不必为此开关指定值。

使用此开关可删除数据加密策略 (PermanentDataPurgeRequested 交换机) 加密的所有数据，但关联的 Azure 密钥保管库也已删除。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Identity

Identity 参数指定要修改的数据加密策略。 可以使用任何能够唯一标识该策略的值。 例如：

• 名称
• 可分辨名称 (DN)
• GUID

Type:	DataEncryptionPolicyIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-Name

Name 参数指定数据加密策略的唯一名称。 如果值包含空格，则使用引号括住该值。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-PermanentDataPurgeContact

PermanentDataPurgeContact 参数指定一个联系人，用于清除数据加密策略加密的所有数据。 如果值包含空格，则使用引号括住该值。

需要将此参数与 PermanentDataPurgeRequested 和 PermanentDataPurgeReason 参数一起使用。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermanentDataPurgeReason

PermanentDataPurgeReason 参数指定清除数据加密策略加密的所有数据的描述性原因。 如果值包含空格，则使用引号括住该值。

需要将此参数与 PermanentDataPurgeRequested 和 PermanentDataPurgeContact 参数一起使用。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermanentDataPurgeRequested

PermanentDataPurgeRequested 开关指定是否启动删除由数据加密策略加密的所有数据。 不必为此开关指定值。

需要将此开关与 PermanentDataPurgeReason 和 PermanentDataPurgeContact 参数一起使用。

使用此开关后，无法将数据加密策略分配给其他邮箱。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Refresh

在轮换 Azure 密钥保管库中的任何关联密钥后，使用“刷新”开关更新 Exchange Online 中的数据加密策略。 不必为此开关指定值。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-WhatIf

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection