Set-AutoSensitivityLabelPolicy

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

AutoEnableAfter 参数允许在模拟中设置的时间段后自动打开策略，无需对策略进行任何修改。 需要在每次编辑策略后显式设置此参数，以保持或重置自动打开时间线。

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

有效值为 1 小时到 25 天。 若要清除与策略关联的现有 AutoEnableAfter 计划，请使用 值$null。

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

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

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

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

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

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

ExceptIfOneDriveSharedBy 参数指定要从策略中排除 (OneDrive for Business用户帐户的网站包含在策略) 。 可以通过 UPN (laura@contoso.onmicrosoft.com) 标识用户。

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

• 该策略已在 Get-AutoSensitivityLabelPolicy 的输出中包含OneDrive for Business站点 (，OneDriveLocation 属性值为 All，这是) 的默认值。
• -AddOneDriveLocation All在同一命令中使用此参数。

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

不能将此参数与 OneDriveSharedBy 参数一起使用。

{{ Fill ExceptIfOneDriveSharedByMemberOf Description }}

{{ Fill ExchangeAdaptiveScopes Description }}

{{ Fill ExchangeAdaptiveScopesException Description }}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{{ 填充位置说明 }}

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

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

{{ Fill OneDriveAdaptiveScopes Description }}

{{ Fill OneDriveAdaptiveScopesException Description }}

OneDriveSharedBy 参数指定要包含在策略中的用户 (策略) OneDrive for Business用户帐户的网站。 可以通过 UPN (laura@contoso.onmicrosoft.com) 标识用户。

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

• 该策略已在 Get-AutoSensitivityLabelPolicy 的输出中包含OneDrive for Business站点 (，OneDriveLocation 属性值为 All，这是) 的默认值。
• -AddOneDriveLocation All在同一命令中使用此参数。

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

不能将此参数与 ExceptIfOneDriveSharedBy 参数一起使用。

{{ Fill OneDriveSharedByMemberOf Description }}

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

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

此参数仅适用于 Exchange 位置。

PolicyRBACScopes 参数指定要分配给策略的管理单元。 有效值是管理单元的 Microsoft Entra ObjectID (GUID 值) 。 可以指定用逗号分隔的多个值。

管理单元仅在 Microsoft Entra ID P1 或 P2 中可用。 在 Microsoft Graph PowerShell 中创建和管理管理单元。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{{ Fill SharePointAdaptiveScopes Description }}

{{ Fill SharePointAdaptiveScopesException Description }}

SpoAipIntegrationEnabled 参数启用或禁用 SharePoint 和 OneDrive 中支持的 Office 文件的内置标记。 有效值包含:

• $true：用户可以在 Office 网页版 中应用敏感度标签。 用户可在功能区上看到“敏感度”按钮，以便应用标签，并在状态栏上看到任何已应用标签的名称。
• $false：用户无法在Office 网页版中应用敏感度标签。 此外，共同创作、电子数据展示、Microsoft Purview 数据丢失防护、搜索和其他协作功能不适用于加密文件。

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

• $true：重启模拟以获取更新的结果。 对自动标记策略的任何编辑都需要使用此值重启模拟。
• $false：这是默认值

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