Set-AutoSensitivityLabelPolicy

模块:

ExchangePowerShell

适用于:

Security & Compliance

此 cmdlet 仅在安全性 & 合规性 PowerShell 中可用。 有关详细信息，请参阅 安全性 & 合规性 PowerShell。

使用 Set-AutoSensitivityLabelPolicy cmdlet 修改组织中的自动标记策略。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-AddExchangeLocation <MultiValuedProperty>]
   [-AddOneDriveLocation <MultiValuedProperty>]
   [-AddOneDriveLocationException <MultiValuedProperty>]
   [-AddSharePointLocation <MultiValuedProperty>]
   [-AddSharePointLocationException <MultiValuedProperty>]
   [-ApplySensitivityLabel <String>]
   [-AutoEnableAfter <Timespan>]
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeSender <SmtpAddress[]>]
   [-ExchangeSenderException <SmtpAddress[]>]
   [-ExchangeSenderMemberOf <SmtpAddress[]>]
   [-ExchangeSenderMemberOfException <SmtpAddress[]>]
   [-ExternalMailRightsManagementOwner <SmtpAddress>]
   [-Force]
   [-Mode <PolicyMode>]
   [-OverwriteLabel <Boolean>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-PolicyTemplateInfo <PswsHashtable>]
   [-Priority <System.Int32>]
   [-RemoveExchangeLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocationException <MultiValuedProperty>]
   [-RemoveSharePointLocation <MultiValuedProperty>]
   [-RemoveSharePointLocationException <MultiValuedProperty>]
   [-SpoAipIntegrationEnabled <Boolean>]
   [-StartSimulation <Boolean>]
   [-SystemOperation]
   [-WhatIf]
   [<CommonParameters>]

Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-Force]
   [-Mode <PolicyMode>]
   [-WhatIf]
   [<CommonParameters>]

Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-Confirm]
   [-Mode <PolicyMode>]
   [-RetryDistribution]
   [-WhatIf]
   [<CommonParameters>]

说明

若要在安全性 & 合规性 PowerShell 中使用此 cmdlet，需要分配权限。 有关详细信息，请参阅 Microsoft Purview 合规门户中的权限。

示例

示例 1

Set-AutoSensitivityLabelPolicy -Identity "Main PII" -AddSharePointLocation "https://my.url1","https://my.url2" -AddOneDriveLocation "https://my.url3","https://my.url4"

本示例将指定的 URL 添加到 SharePoint Online，并OneDrive for Business名为 Main PII 的自动标记策略的位置，而不会影响现有 URL 值。

参数

-AddExchangeLocation

AddExchangeLocation 参数会将电子邮件添加到策略（如果尚未包含这些邮件）。 此参数的有效值为 All。

如果策略尚未在 Get-AutoSensitivityLabelPolicy cmdlet 的输出中包含电子邮件 (，则 ExchangeLocation 属性值为空白) ，则可以在以下过程中使用此参数：

• 如果单独使用 -AddExchangeLocation All ，则策略将应用于所有内部用户的电子邮件。

• 若要在策略中包含特定内部或外部用户的电子邮件，请在 -AddExchangeLocation All 同一命令中使用 ExchangeSender 参数。 策略中仅包含指定用户的电子邮件。

• 若要在策略中包含特定组成员的电子邮件，请在 -AddExchangeLocation All 同一命令中使用 ExchangeSenderMemberOf 参数。 策略中仅包含指定组成员的电子邮件。

• 若要从策略中排除特定内部用户的电子邮件，请在 -AddExchangeLocation All 同一命令中使用 ExchangeSenderException 参数。 仅从策略中排除指定用户的电子邮件。

• 若要从策略中排除特定组成员的电子邮件，请在 -AddExchangeLocation All 同一命令中使用 ExchangeSenderMemberOfException 参数。 仅从策略中排除指定组成员的电子邮件。

不能在同一策略中指定包含项和排除项。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-AddOneDriveLocation

AddOneDriveLocation 参数指定要在未对 OneDriveLocation 参数使用值 All 时添加到包含网站列表中的OneDrive for Business网站。 可以按 URL 值标识网站。

若要输入多个值，请使用以下语法： <value1>,<value2>,...<valueX>。 如果值包含空格或需要引号，请使用以下语法： "<value1>","<value2>",..."<valueX>"。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-AddOneDriveLocationException

当对 OneDriveLocation 参数使用值 All 时，AddOneDriveLocationException 参数指定要添加到已排除网站列表中的OneDrive for Business站点。 可以按 URL 值标识网站。

若要输入多个值，请使用以下语法： <value1>,<value2>,...<valueX>。 如果值包含空格或需要引号，请使用以下语法： "<value1>","<value2>",..."<valueX>"。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-AddSharePointLocation

AddSharePointLocation 参数指定要在未对 SharePointLocation 参数使用值 All 时添加到包含网站列表的 SharePoint Online 网站。 可以按 URL 值标识网站。

在为 SharePoint Online 网站编制索引之前，无法将其添加到策略。

若要输入多个值，请使用以下语法： <value1>,<value2>,...<valueX>。 如果值包含空格或需要引号，请使用以下语法： "<value1>","<value2>",..."<valueX>"。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-AddSharePointLocationException

当对 SharePointLocation 参数使用值 All 时，AddSharePointLocationException 参数指定要添加到已排除网站列表的 SharePoint Online 网站。 可以按 URL 值标识网站。

若要输入多个值，请使用以下语法： <value1>,<value2>,...<valueX>。 如果值包含空格或需要引号，请使用以下语法： "<value1>","<value2>",..."<valueX>"。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ApplySensitivityLabel

ApplySensitivityLabel 参数选择要用于策略的标签。 这将覆盖策略上的上一个标签。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-AutoEnableAfter

AutoEnableAfter 参数允许在模拟中设置的时间段后自动打开策略。 每当修改策略或触发模拟时，时间段就会重启。

若要指定值，请以时间跨度格式 dd.hh:mm:ss 输入值（其中 dd = 天，hh = 小时，mm = 分钟，ss = 秒）。

有效值为 1 小时到 25 天。

必须将此参数与 -StartSimulation 参数一起使用。

Type:	System.TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Comment

Comment 参数指定可选注释。 如果您指定包含空格的值，为该值加上双引号(")，例如："这是管理员备注"。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-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:	Security & Compliance

-Enabled

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

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ExchangeSender

ExchangeSender 参数指定策略中包含其电子邮件的用户。 按电子邮件地址指定用户。 可以指定内部或外部电子邮件地址。

若要输入多个值，请使用以下语法： <value1>,<value2>,...<valueX>。 如果值包含空格或需要引号，请使用以下语法： "<value1>","<value2>",..."<valueX>"。

若要使用此参数，以下语句之一必须为 true：

• 该策略已在 Get-AutoSensitivityLabelPolicy cmdlet 的输出中包含电子邮件 (，ExchangeLocation 属性值为 All) 。
• -AddExchangeLocation All在同一命令中使用此参数。

不能将此参数与 ExchangeSenderException 或 ExchangeSenderMemberOfException 参数一起使用。

Type:	SmtpAddress[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ExchangeSenderException

ExchangeSenderException 参数指定从策略中排除其电子邮件的内部用户。 按电子邮件地址标识用户。

若要输入多个值，请使用以下语法： <value1>,<value2>,...<valueX>。 如果值包含空格或需要引号，请使用以下语法： "<value1>","<value2>",..."<valueX>"。

若要使用此参数，以下语句之一必须为 true：

• 该策略已在 Get-AutoSensitivityLabelPolicy 的输出中包含电子邮件 (，ExchangeLocation 属性值为 All) 。
• -AddExchangeLocation All在同一命令中使用此参数。

不能将此参数与 ExchangeSender 或 ExchangeSenderMemberOf 参数一起使用。

Type:	SmtpAddress[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ExchangeSenderMemberOf

ExchangeSenderMemberOf 参数指定要包含在策略中的通讯组或启用邮件的安全组， (组成员的电子邮件包含在策略) 中。 按电子邮件地址标识组。

若要输入多个值，请使用以下语法： <value1>,<value2>,...<valueX>。 如果值包含空格或需要引号，请使用以下语法： "<value1>","<value2>",..."<valueX>"。

若要使用此参数，以下语句之一必须为 true：

• 该策略已在 Get-AutoSensitivityLabelPolicy 的输出中包含电子邮件 (，ExchangeLocation 属性值为 All) 。
• -AddExchangeLocation All在同一命令中使用此参数。

不能将此参数与 ExchangeSenderException 或 ExchangeSenderMemberOfException 参数一起使用。

不能使用此参数指定Microsoft 365 组。

Type:	SmtpAddress[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ExchangeSenderMemberOfException

ExchangeSenderMemberOfException 参数指定要从策略中排除的通讯组或启用邮件的安全组， (组成员的电子邮件将从策略) 中排除。 按电子邮件地址标识组。

若要输入多个值，请使用以下语法： <value1>,<value2>,...<valueX>。 如果值包含空格或需要引号，请使用以下语法： "<value1>","<value2>",..."<valueX>"。

若要使用此参数，以下语句之一必须为 true：

• 该策略已在 Get-AutoSensitivityLabelPolicy 的输出中包含电子邮件 (，ExchangeLocation 属性值为 All) 。
• -AddExchangeLocation All在同一命令中使用此参数。

不能将此参数与 ExchangeSender 或 ExchangeSenderMemberOf 参数一起使用。

不能使用此参数指定Microsoft 365 组。

Type:	SmtpAddress[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ExternalMailRightsManagementOwner

ExternalMailRightsManagementOwner 参数指定用户邮箱的电子邮件地址，该邮箱用于使用 RMS 加密来自外部发件人的传入电子邮件。

此参数仅适用于 Exchange 位置，并且策略必须应用具有加密操作的标签。

若要清除现有电子邮件地址，请使用值 $null。

Type:	SmtpAddress
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Force

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

您可以在以编程方式运行任务时使用此开关，因为此时并不适合提示用户提供管理输入。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Identity

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

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

Type:	PolicyIdParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Mode

Mode 参数指定自动标记策略的操作和通知级别。 有效值包含:

• 启用：为操作和通知启用策略。
• Enable：为操作和通知启用此策略。此为默认值。
• TestWithNotifications：不支持。
• TestWithoutNotifications：一种审核模式，其中不执行任何操作，并且不会 (测试模式) 发送通知。

Type:	PolicyMode
Accepted values:	Enable, TestWithNotifications, TestWithoutNotifications, Disable, PendingDeletion
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-OverwriteLabel

OverwriteLabel 参数指定是否覆盖手动标签。 有效值包含:

• $true：覆盖手动标签。
• $false：不要覆盖手动标签。 此值为默认值。

此参数仅适用于 Exchange 位置。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-PolicyRBACScopes

{{ Fill PolicyRBACScopes Description }}

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-PolicyTemplateInfo

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

Type:	PswsHashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Priority

Priority 参数指定用于确定策略处理顺序的策略的优先级值。 整数值越小表示优先级越高，值 0 表示优先级最高，策略不能具有相同的优先级值。

此参数的有效值和默认值取决于现有策略的数量。 例如，如果有 5 个现有策略：

• 现有 5 个策略的有效优先级值为 0 到 4。
• 新第 6 个策略的有效优先级值为 0 到 5。
• 新第 6 个策略的默认值为 5。

如果修改策略的优先级值，则策略在列表中的位置会发生变化，以匹配指定的优先级值。 换句话说，如果将策略的优先级值设置为与现有策略相同的值，则现有策略的优先级值和所有其他低优先级策略的优先级值在增加 1 后。

Type:	System.Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RemoveExchangeLocation

RemoveExchangeLocation 参数从策略中删除电子邮件（如果已包含这些邮件）。 此参数的有效值为 All。

如果策略已将电子邮件 (包含在 Get-AutoSensitivityLabelPolicy cmdlet 的输出中，则 ExchangeLocation 属性值为“全部) ”，可以使用 -RemoveExchangeLocation All 来阻止策略应用于电子邮件。

如果电子邮件 (任何关联规则使用 Exchange) 的值，则不能使用此参数。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RemoveOneDriveLocation

RemoveOneDriveLocation 参数指定要在未对 OneDriveLocation 参数使用值 All 时从包含网站列表中删除的OneDrive for Business网站。 可以按 URL 值标识网站。

若要输入多个值，请使用以下语法： <value1>,<value2>,...<valueX>。 如果值包含空格或需要引号，请使用以下语法： "<value1>","<value2>",..."<valueX>"。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RemoveOneDriveLocationException

当对 OneDriveLocation 参数使用值 All 时，此 RemoveOneDriveLocationException 参数指定要从排除网站列表中删除的OneDrive for Business网站。 可以按 URL 值标识网站。

若要输入多个值，请使用以下语法： <value1>,<value2>,...<valueX>。 如果值包含空格或需要引号，请使用以下语法： "<value1>","<value2>",..."<valueX>"。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RemoveSharePointLocation

RemoveSharePointLocation 参数指定要在未对 SharePointLocation 参数使用值 All 时从包含网站列表中删除的 SharePoint Online 网站。 可以按 URL 值标识网站。

若要输入多个值，请使用以下语法： <value1>,<value2>,...<valueX>。 如果值包含空格或需要引号，请使用以下语法： "<value1>","<value2>",..."<valueX>"。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RemoveSharePointLocationException

RemoveSharePointLocationException 参数指定要在对 SharePointLocation 参数使用值 All 时从排除网站列表中删除的 SharePoint Online 网站。 可以按 URL 值标识网站。

若要输入多个值，请使用以下语法： <value1>,<value2>,...<valueX>。 如果值包含空格或需要引号，请使用以下语法： "<value1>","<value2>",..."<valueX>"。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RetryDistribution

RetryDistribution 开关将策略重新分发到所有OneDrive for Business和 SharePoint Online 位置。 不必为此开关指定值。

成功完成初始分发的位置不包括在重试范围内。 使用此开关时，会报告策略分配错误。

注意：由于重试分发的过程是一项重大操作，因此仅在必要时运行它，一次运行一个策略。 并非每次更新策略时都会运行它。 如果运行脚本来更新多个策略，请等待策略分发成功，然后再次为下一个策略运行命令。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-SpoAipIntegrationEnabled

{{ Fill SpoAipIntegrationEnabled Description }}

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-StartSimulation

使用 StartSimulation 参数重启模拟以获取更新的结果。 有效值包含:

• $true：重启模拟以获取更新的结果。
• $false：这是默认值

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-SystemOperation

{{ Fill SystemOperation Description }}

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-WhatIf

WhatIf 开关在安全 & 合规性 PowerShell 中不起作用。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance