New-AutoSensitivityLabelPolicy

此 cmdlet 仅在安全与合规中心 PowerShell 内可用。 有关更多信息,请参见 安全与合规中心 PowerShell。

使用 New-AutoSensitivityLabelPolicy cmdlet 在组织中创建自动标记策略。 使用 New-AutoSensitivityLabelRule cmdlet 创建自动标记策略规则,并将其与策略关联以完成策略创建。

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

语法

Default (默认值)

New-AutoSensitivityLabelPolicy
    [-Name] <String>
    -ApplySensitivityLabel <String>
    [-ApplySensitivityLabelOverwriteWorkloads <Workload>]
    [-Comment <String>]
    [-Confirm]
    [-ExceptIfOneDriveSharedBy <RecipientIdParameter[]>]
    [-ExceptIfOneDriveSharedByMemberOf <RecipientIdParameter[]>]
    [-ExchangeAdaptiveScopes <MultiValuedProperty>]
    [-ExchangeAdaptiveScopesException <MultiValuedProperty>]
    [-ExchangeLocation <MultiValuedProperty>]
    [-ExchangeSender <SmtpAddress[]>]
    [-ExchangeSenderException <SmtpAddress[]>]
    [-ExchangeSenderMemberOf <SmtpAddress[]>]
    [-ExchangeSenderMemberOfException <SmtpAddress[]>]
    [-ExternalMailRightsManagementOwner <SmtpAddress>]
    [-Force]
    [-Locations <String>]
    [-Mode <PolicyMode>]
    [-OneDriveAdaptiveScopes <MultiValuedProperty>]
    [-OneDriveAdaptiveScopesException <MultiValuedProperty>]
    [-OneDriveLocation <MultiValuedProperty>]
    [-OneDriveLocationException <MultiValuedProperty>]
    [-OneDriveSharedBy <RecipientIdParameter[]>]
    [-OneDriveSharedByMemberOf <RecipientIdParameter[]>]
    [-OverwriteLabel <Boolean>]
    [-PolicyRBACScopes <MultiValuedProperty>]
    [-PolicyTemplateInfo <PswsHashtable>]
    [-Priority <System.Int32>]
    [-RemoveLabel]
    [-SharePointAdaptiveScopes <MultiValuedProperty>]
    [-SharePointAdaptiveScopesException <MultiValuedProperty>]
    [-SharePointLocation <MultiValuedProperty>]
    [-SharePointLocationException <MultiValuedProperty>]
    [-UnifiedAuditLogEnabled <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

说明

要在安全与合规中心 PowerShell 中使用此 cmdlet,必须分配权限。 有关详细信息,请参阅 Microsoft Purview 合规门户中的权限。

示例

示例 1

New-AutoSensitivityLabelPolicy -Name "GlobalPolicy" -Comment "Primary policy" -SharePointLocation "https://my.url","https://my.url2" -OneDriveLocation "https://my.url3","https://my.url4" -Mode TestWithoutNotifications -ApplySensitivityLabel "Test"

此示例为标签为“测试”的指定 SharePoint 和 OneDrive 位置创建一个名为 GlobalPolicy 的自动标记策略。 新策略具有描述性注释,并在模拟模式下创建。

示例 2

New-AutoSensitivityLabelPolicy -Name "RemoveLabelPolicy" -SharePointLocation "https://contoso.sharepoint.com/sites/Research" -OneDriveLocation All -Mode TestWithoutNotifications -RemoveLabel -ApplySensitivityLabel "00000000-0000-0000-0000-000000000000"

此示例在模拟模式下创建一个自动标记策略,该策略将从 SharePoint Online 和 OneDrive 中的匹配内容中删除现有的敏感度标签。 若要删除标签,ApplySensitivityLabel 参数需要空 GUID。 使用 New-AutoSensitivityLabelRule 创建的关联规则的 AdvancedRule 配置标识要删除的特定标签。

参数

-ApplySensitivityLabel

适用:安全性 & 合规性

ApplySensitivityLabel 参数指定要与自动标记策略一起应用的标签。

对 SharePoint Online 或 OneDrive 使用 RemoveLabel 开关时,此参数仍然是必需的,但必须使用空的 GUID 00000000-0000-0000-0000-000000000000。 关联 New-AutoSensitivityLabelRule 的 AdvancedRule 配置标识要删除的特定现有标签。 不要在此参数中指定要删除的标签的 GUID;这样做会导致策略部署错误。

参数属性

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

参数集

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

-ApplySensitivityLabelOverwriteWorkloads

适用:安全性 & 合规性

{{ 填充 ApplySensitivityLabelOverwriteWorkloads 说明 }}

参数属性

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

参数集

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

-Comment

适用:安全性 & 合规性

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

参数属性

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

参数集

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

-Confirm

适用:安全性 & 合规性

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

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

参数属性

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

参数集

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

-ExceptIfOneDriveSharedBy

适用:安全性 & 合规性

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

若要使用此参数, (OneDriveLocation 参数值为 All(这是) 的默认值)时,需要将 OneDrive 网站包含在策略中。

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

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

参数属性

类型:

RecipientIdParameter[]

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

参数集

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

-ExceptIfOneDriveSharedByMemberOf

适用:安全性 & 合规性

{{ Fill ExceptIfOneDriveSharedByMemberOf Description }}

参数属性

类型:

RecipientIdParameter[]

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

参数集

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

-ExchangeAdaptiveScopes

适用:安全性 & 合规性

{{ 填充 ExchangeAdaptiveScopes 说明 }}

参数属性

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

参数集

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

-ExchangeAdaptiveScopesException

适用:安全性 & 合规性

{{ 填充 ExchangeAdaptiveScopesException 说明 }}

参数属性

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

参数集

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

-ExchangeLocation

适用:安全性 & 合规性

ExchangeLocation 参数指定是否在策略中包括电子邮件。 此参数的有效值为“全部”。 如果不想在策略中包含电子邮件,请不要使用此参数 (默认值为空白或$null) 。

可以在以下过程中使用此参数:

  • 如果单独使用 -ExchangeLocation All ,则该策略适用于所有内部用户的电子邮件。

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

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

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

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

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

参数属性

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

参数集

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

-ExchangeSender

适用:安全性 & 合规性

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

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

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

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

参数属性

类型:

SmtpAddress[]

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

参数集

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

-ExchangeSenderException

适用:安全性 & 合规性

ExchangeSenderException 参数指定其电子邮件将从策略中排除的内部用户。 您可以通过电子邮件地址标识用户。

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

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

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

参数属性

类型:

SmtpAddress[]

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

参数集

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

-ExchangeSenderMemberOf

适用:安全性 & 合规性

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

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

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

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

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

参数属性

类型:

SmtpAddress[]

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

参数集

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

-ExchangeSenderMemberOfException

适用:安全性 & 合规性

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

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

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

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

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

参数属性

类型:

SmtpAddress[]

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

参数集

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

-ExternalMailRightsManagementOwner

适用:安全性 & 合规性

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

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

参数属性

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

参数集

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

-Force

适用:安全性 & 合规性

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

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

参数属性

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

参数集

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

-Locations

适用:安全性 & 合规性

{{ 填充位置说明 }}

参数属性

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

参数集

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

-Mode

适用:安全性 & 合规性

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

  • 启用:为操作和通知启用策略。 此值为默认值。
  • Enable:为操作和通知启用此策略。此为默认值。
  • Disable:禁用此策略。
  • TestWithNotifications:不执行任何操作,但发送通知。

参数属性

类型:PolicyMode
默认值:None
接受的值:Enable, TestWithNotifications, TestWithoutNotifications, Disable, PendingDeletion
支持通配符:False
不显示:False

参数集

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

-Name

适用:安全性 & 合规性

Name 参数指定自动标记策略的唯一名称。 如果值包含空格,请用引号 (“) 将值括起来。

参数属性

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

参数集

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

-OneDriveAdaptiveScopes

适用:安全性 & 合规性

{{ 填充 OneDriveAdaptiveScopes 说明 }}

参数属性

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

参数集

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

-OneDriveAdaptiveScopesException

适用:安全性 & 合规性

{{ 填充 OneDriveAdaptiveScopesException 说明 }}

参数属性

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

参数集

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

-OneDriveLocation

适用:安全性 & 合规性

OneDriveLocation 参数指定要包含在策略中的 OneDrive 网站。 可以按 URL 值标识网站,也可以使用值 All 添加所有网站。

Update 如果值中有空格或需要使用双引号,请使用以下语法:"Value1","Value2",..."ValueN"。

参数属性

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

参数集

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

-OneDriveLocationException

适用:安全性 & 合规性

此参数指定在将值“全部”用于 OneDriveLocation 参数时要排除的 OneDrive 网站。 可以按 URL 值标识网站。

Update 如果值中有空格或需要使用双引号,请使用以下语法:"Value1","Value2",..."ValueN"。

参数属性

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

参数集

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

-OneDriveSharedBy

适用:安全性 & 合规性

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

若要使用此参数, (OneDriveLocation 参数值为 All(这是) 的默认值)时,需要将 OneDrive 网站包含在策略中。

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

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

参数属性

类型:

RecipientIdParameter[]

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

参数集

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

-OneDriveSharedByMemberOf

适用:安全性 & 合规性

{{ Fill OneDriveSharedByMemberOf Description }}

参数属性

类型:

RecipientIdParameter[]

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

参数集

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

-OverwriteLabel

适用:安全性 & 合规性

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

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

此参数仅适用于 Exchange 位置。

参数属性

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

参数集

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

-PolicyRBACScopes

适用:安全性 & 合规性

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

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

参数属性

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

参数集

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

-PolicyTemplateInfo

适用:安全性 & 合规性

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

参数属性

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

参数集

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

-Priority

适用:安全性 & 合规性

优先级参数指定策略的优先级。 如果两个策略适用于一个文件,则最高优先级策略优先于低优先级策略。

参数属性

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

参数集

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

-RemoveLabel

适用:安全性 & 合规性

RemoveLabel 开关指定自动标记策略从 SharePoint Online 或 OneDrive 中的匹配内容中删除现有的敏感度标签,包括用户手动应用的标签。 不标记匹配内容。 不必为此开关指定值。

使用此开关时,请将 ApplySensitivityLabel 参数设置为空 GUID 00000000-0000-0000-0000-000000000000。 使用 New-AutoSensitivityLabelRule 创建的关联规则的 AdvancedRule 配置标识要删除的特定现有标签。

建议在模拟模式下创建策略,并在启用策略之前查看结果。

参数属性

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

参数集

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

-SharePointAdaptiveScopes

适用:安全性 & 合规性

{{ 填充 SharePointAdaptiveScopes 说明 }}

参数属性

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

参数集

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

-SharePointAdaptiveScopesException

适用:安全性 & 合规性

{{ 填充 SharePointAdaptiveScopesException 说明 }}

参数属性

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

参数集

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

-SharePointLocation

适用:安全性 & 合规性

SharePointLocation 参数指定要包含在策略中的 SharePoint 网站。 可以按 URL 值标识网站,也可以使用值 All 添加所有网站。

Update 如果值中有空格或需要使用双引号,请使用以下语法:"Value1","Value2",..."ValueN"。 在索引之前,无法将 SharePoint 网站添加到策略中。

参数属性

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

参数集

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

-SharePointLocationException

适用:安全性 & 合规性

此参数指定将值“全部”用于 SharePointLocation 参数时要排除的 SharePoint 网站。 可以按 URL 值标识网站。

Update 如果值中有空格或需要使用双引号,请使用以下语法:"Value1","Value2",..."ValueN"。

参数属性

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

参数集

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

-UnifiedAuditLogEnabled

适用:安全性 & 合规性

{{ Fill UnifiedAuditLogEnabled 说明 }}

参数属性

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

参数集

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

-WhatIf

适用:安全性 & 合规性

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

参数属性

类型: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。