Set-DataEncryptionPolicy

此 cmdlet 仅在基于云的服务中可用。

使用 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>]

说明

您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 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 Description }}

参数属性

类型: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-* cmdlet)都没有内置暂停。 对于这些 cmdlet,在不带值的情况下指定“确认”开关会引入一个暂停,从而强制你在继续之前确认命令。

此 cmdlet 具有内置的暂停,因此请跳 -Confirm:$false 过确认。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Description

适用:Exchange Online

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

参数属性

类型: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,用于本地邮箱的内置安全加载项

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

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

TenantAdminPurgeKeyRequest
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
DCAdminPurgeKeyRequest
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Identity

适用:Exchange Online

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

  • 名称
  • 可分辨名称 (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。