New-AutoSensitivityLabelPolicy

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

使用 New-AutoSensitivityLabelPolicy cmdlet 在组织中创建自动标记策略。 使用 New-AutoSensitivityLabelRule cmdlet 创建自动标记策略规则,并使用策略来完成策略创建。

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

语法

New-AutoSensitivityLabelPolicy
   [-Name] <String>
   -ApplySensitivityLabel <String>
   [-Comment <String>]
   [-Confirm]
   [-ExchangeLocation <MultiValuedProperty>]
   [-ExchangeSender <SmtpAddress[]>]
   [-ExchangeSenderException <SmtpAddress[]>]
   [-ExchangeSenderMemberOf <SmtpAddress[]>]
   [-ExchangeSenderMemberOfException <SmtpAddress[]>]
   [-ExternalMailRightsManagementOwner <SmtpAddress>]
   [-Force]
   [-Mode <PolicyMode>]
   [-OneDriveLocation <MultiValuedProperty>]
   [-OneDriveLocationException <MultiValuedProperty>]
   [-OverwriteLabel <Boolean>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-PolicyTemplateInfo <PswsHashtable>]
   [-Priority <System.Int32>]
   [-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 Online 创建名为 GlobalPolicy 的自动标记策略,并使用标签“Test”OneDrive for Business位置。 新策略具有描述性注释,创建时将处于模拟模式。

参数

-ApplySensitivityLabel

ApplySensitivityLabel 参数指定要用于自动标记策略的标签。

Type:String
Position:Named
Default value:None
Required:True
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

-ExchangeLocation

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

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

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

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

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

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

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

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

Type:MultiValuedProperty
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>"

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

不能将此参数与 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>"

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

不能将此参数与 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>"

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

不能将此参数与 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>"

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

不能将此参数与 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 位置,并且策略必须应用具有加密操作的标签。

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

-Mode

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

  • 启用:为操作和通知启用策略。 此值为默认值。
  • Enable:为操作和通知启用此策略。此为默认值。
  • Disable:禁用此策略。
  • TestWithNotifications:不执行任何操作,但发送通知。
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

-Name

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

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

-OneDriveLocation

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

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

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

-OneDriveLocationException

此参数指定要在对 OneDriveLocation 参数使用值 All 时排除OneDrive for Business网站。 可以按 URL 值标识网站。

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

Type:MultiValuedProperty
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 参数指定策略的优先级。 如果两个策略适用于文件,则最高优先级策略将采取对较低优先级策略的操作。

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

-SharePointLocation

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

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

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

-SharePointLocationException

此参数指定要在对 SharePointLocation 参数使用值 All 时排除的 SharePoint Online 网站。 可以按 URL 值标识网站。

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

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

-UnifiedAuditLogEnabled

{{ Fill UnifiedAuditLogEnabled Description }}

Type:Boolean
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