Set-AutoSensitivityLabelPolicy

语法

Identity

Set-AutoSensitivityLabelPolicy
    [-Identity] <PolicyIdParameter>
    [-AddExchangeLocation <MultiValuedProperty>]
    [-AddOneDriveLocation <MultiValuedProperty>]
    [-AddOneDriveLocationException <MultiValuedProperty>]
    [-AddSharePointLocation <MultiValuedProperty>]
    [-AddSharePointLocationException <MultiValuedProperty>]
    [-ApplySensitivityLabel <String>]
    [-AutoEnableAfter <Timespan>]
    [-Comment <String>]
    [-Confirm]
    [-Enabled <Boolean>]
    [-ExceptIfOneDriveSharedBy <RecipientIdParameter[]>]
    [-ExceptIfOneDriveSharedByMemberOf <RecipientIdParameter[]>]
    [-ExchangeAdaptiveScopes <MultiValuedProperty>]
    [-ExchangeAdaptiveScopesException <MultiValuedProperty>]
    [-ExchangeSender <SmtpAddress[]>]
    [-ExchangeSenderException <SmtpAddress[]>]
    [-ExchangeSenderMemberOf <SmtpAddress[]>]
    [-ExchangeSenderMemberOfException <SmtpAddress[]>]
    [-ExternalMailRightsManagementOwner <SmtpAddress>]
    [-Force]
    [-Locations <String>]
    [-Mode <PolicyMode>]
    [-OneDriveAdaptiveScopes <MultiValuedProperty>]
    [-OneDriveAdaptiveScopesException <MultiValuedProperty>]
    [-OneDriveSharedBy <RecipientIdParameter[]>]
    [-OneDriveSharedByMemberOf <RecipientIdParameter[]>]
    [-OverwriteLabel <Boolean>]
    [-PolicyRBACScopes <MultiValuedProperty>]
    [-PolicyTemplateInfo <PswsHashtable>]
    [-Priority <System.Int32>]
    [-RemoveExchangeLocation <MultiValuedProperty>]
    [-RemoveOneDriveLocation <MultiValuedProperty>]
    [-RemoveOneDriveLocationException <MultiValuedProperty>]
    [-RemoveSharePointLocation <MultiValuedProperty>]
    [-RemoveSharePointLocationException <MultiValuedProperty>]
    [-SharePointAdaptiveScopes <MultiValuedProperty>]
    [-SharePointAdaptiveScopesException <MultiValuedProperty>]
    [-SpoAipIntegrationEnabled <Boolean>]
    [-StartSimulation <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

TeamLocation

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

RetryDistributionParameterSet

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

说明

示例

示例 1

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

参数

-AddExchangeLocation

适用：安全 & 合规性

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

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

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

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

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

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

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

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

参数属性

参数集

-AddOneDriveLocation

适用：安全 & 合规性

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

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

参数属性

参数集

-AddOneDriveLocationException

适用：安全 & 合规性

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

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

参数属性

参数集

-AddSharePointLocation

适用：安全 & 合规性

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

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

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

参数属性

参数集

-AddSharePointLocationException

适用：安全 & 合规性

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

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

参数属性

参数集

-ApplySensitivityLabel

适用：安全 & 合规性

ApplySensitivityLabel 参数选择要用于策略的标签。 此值替代策略上的上一个标签。

参数属性

参数集

-AutoEnableAfter

适用：安全 & 合规性

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

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

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

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

参数属性

参数集

-Comment

适用：安全 & 合规性

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

参数属性

参数集

-Confirm

适用：安全 & 合规性

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

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

参数属性

参数集

-Enabled

适用：安全 & 合规性

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

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

参数属性

参数集

-ExceptIfOneDriveSharedBy

适用：安全 & 合规性

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

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

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

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

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

参数属性

参数集

-ExceptIfOneDriveSharedByMemberOf

适用：安全 & 合规性

{{ Fill ExceptIfOneDriveSharedByMemberOf Description }}

参数属性

参数集

-ExchangeAdaptiveScopes

适用：安全 & 合规性

{{ Fill ExchangeAdaptiveScopes Description }}

参数属性

参数集

-ExchangeAdaptiveScopesException

适用：安全 & 合规性

{{ Fill ExchangeAdaptiveScopesException Description }}

参数属性

参数集

-ExchangeSender

适用：安全 & 合规性

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

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

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

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

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

参数属性

参数集

-ExchangeSenderException

适用：安全 & 合规性

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

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

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

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

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

参数属性

参数集

-ExchangeSenderMemberOf

适用：安全 & 合规性

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

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

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

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

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

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

参数属性

参数集

-ExchangeSenderMemberOfException

适用：安全 & 合规性

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

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

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

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

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

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

参数属性

参数集

-ExternalMailRightsManagementOwner

适用：安全 & 合规性

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

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

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

参数属性

参数集

-Force

适用：安全 & 合规性

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

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

参数属性

参数集

-Identity

适用：安全 & 合规性

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

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

参数属性

参数集

-Locations

适用：安全 & 合规性

{{ 填充位置说明 }}

参数属性

参数集

-Mode

适用：安全 & 合规性

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

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

参数属性

参数集

-OneDriveAdaptiveScopes

适用：安全 & 合规性

{{ Fill OneDriveAdaptiveScopes Description }}

参数属性

参数集

-OneDriveAdaptiveScopesException

适用：安全 & 合规性

{{ Fill OneDriveAdaptiveScopesException Description }}

参数属性

参数集

-OneDriveSharedBy

适用：安全 & 合规性

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

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

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

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

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

参数属性

参数集

-OneDriveSharedByMemberOf

适用：安全 & 合规性

{{ Fill OneDriveSharedByMemberOf Description }}

参数属性

参数集

-OverwriteLabel

适用：安全 & 合规性

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

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

此参数仅适用于 Exchange 位置。

参数属性

参数集

-PolicyRBACScopes

适用：安全 & 合规性

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

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

参数属性

参数集

-PolicyTemplateInfo

适用：安全 & 合规性

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

参数属性

参数集

-Priority

适用：安全 & 合规性

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

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

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

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

参数属性

参数集

-RemoveExchangeLocation

适用：安全 & 合规性

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

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

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

参数属性

参数集

-RemoveOneDriveLocation

适用：安全 & 合规性

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

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

参数属性

参数集

-RemoveOneDriveLocationException

适用：安全 & 合规性

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

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

参数属性

参数集

-RemoveSharePointLocation

适用：安全 & 合规性

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

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

参数属性

参数集

-RemoveSharePointLocationException

适用：安全 & 合规性

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

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

参数属性

参数集

-RetryDistribution

适用：安全 & 合规性

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

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

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

参数属性

参数集

-SharePointAdaptiveScopes

适用：安全 & 合规性

{{ Fill SharePointAdaptiveScopes Description }}

参数属性

参数集

-SharePointAdaptiveScopesException

适用：安全 & 合规性

{{ Fill SharePointAdaptiveScopesException Description }}

参数属性

参数集

-SpoAipIntegrationEnabled

适用：安全 & 合规性

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

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

参数属性

参数集

-StartSimulation

适用：安全 & 合规性

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

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

参数属性

参数集

-WhatIf

适用：安全 & 合规性

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

参数属性

参数集

CommonParameters