Set-AutoSensitivityLabelPolicy
此 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 |
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈