New-LabelPolicy

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

使用 New-LabelPolicy cmdlet 在组织中创建敏感度标签策略。

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

语法

New-LabelPolicy
   -Name <String>
   -Labels <MultiValuedProperty>
   [-AdvancedSettings <PswsHashtable>]
   [-Comment <String>]
   [-Confirm]
   [-ExchangeLocation <MultiValuedProperty>]
   [-ExchangeLocationException <MultiValuedProperty>]
   [-Force]
   [-MigrationId <String>]
   [-ModernGroupLocation <MultiValuedProperty>]
   [-ModernGroupLocationException <MultiValuedProperty>]
   [-OneDriveLocation <MultiValuedProperty>]
   [-OneDriveLocationException <MultiValuedProperty>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-PublicFolderLocation <MultiValuedProperty>]
   [-Setting <PswsHashtable>]
   [-Settings <PswsHashtable>]
   [-SharePointLocation <MultiValuedProperty>]
   [-SharePointLocationException <MultiValuedProperty>]
   [-SkypeLocation <MultiValuedProperty>]
   [-SkypeLocationException <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

说明

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

示例

示例 1

New-LabelPolicy -Name "Research and Development" -Labels "R and D","R and D Management"

此示例创建名为“研发”的敏感度标签策略,该策略包含名为 R 和 D 以及 R 和 D Management 的敏感度标签。

参数

-AdvancedSettings

AdvancedSettings 参数为敏感度标签策略启用客户端特定的特性和功能。

使用标识 (名称或策略的 GUID) 指定此参数,并在 哈希表中包含键/值对。 若要删除高级设置,请使用相同的 AdvancedSettings 参数语法,但指定 null 字符串值。

使用此参数配置的某些设置仅受 Azure 信息保护统一标记客户端的支持,不支持支持内置标记的 Office 应用。 有关说明,请参阅 Azure 信息保护统一标记客户端的自定义配置

内置标签支持的设置:

  • AttachmentAction:未标记的电子邮件从文件附件继承最高优先级标签。 将值设置为 “自动 (”,以自动将标签) 或 建议 (作为建议提示应用于用户。 示例:New-LabelPolicy -Identity Global -AdvancedSettings @{AttachmentAction="Automatic"}。 有关此配置选项的详细信息,请参阅 配置电子邮件附件中的标签继承

  • EnableAudit:阻止 Office 应用向 Microsoft 365 审核解决方案发送敏感度标签数据。 支持的应用:Windows (版本 2201+) 上的 Word、Excel 和 PowerPoint、macOS (版本 16.57+) 、iOS (版本 2.57+) 和 Android (版本 16.0.14827+) ;Windows 版 Outlook (版本 2201+) 、Outlook 网页版,并将其推广到 macOS、iOS 和 Android。 示例:New-LabelPolicy -Identity Global -AdvancedSettings @{EnableAudit="False"}

  • DisableMandatoryInOutlook:支持此设置的 Outlook 应用从强制标记中免除 Outlook 邮件。 示例:New-LabelPolicy -Identity Global -AdvancedSettings @{DisableMandatoryInOutlook="True"}。 有关此配置选项的详细信息,请参阅 默认标签和强制标记的特定于 Outlook 的选项

  • OutlookDefaultLabel:支持此设置的 Outlook 应用应用默认标签或无标签。 示例:New-LabelPolicy -Identity Global -AdvancedSettings @{OutlookDefaultLabel="None"}。 有关此配置选项的详细信息,请参阅 默认标签和强制标记的特定于 Outlook 的选项

  • TeamworkMandatory:支持此设置的 Outlook 和 Teams 应用可以启用或禁用会议的强制标记。 示例:New-LabelPolicy -Identity Global -AdvancedSettings @{TeamworkMandatory="True"}。 有关标记会议的详细信息,请参阅 使用敏感度标签保护日历项目、Teams 会议和聊天

  • teamworkdefaultlabelid:支持此设置的 Outlook 和 Teams 应用对会议应用默认标签或无标签。 示例:New-LabelPolicy -Identity Global -AdvancedSettings @{teamworkdefaultlabelid="General"}。 有关标记会议的详细信息,请参阅 使用敏感度标签保护日历项目、Teams 会议和聊天

  • HideBarByDefault:对于支持敏感度栏的 Office 应用,不要在窗口栏标题上显示敏感度标签名称,以便有更多的空间显示长文件名。 仅显示标签图标和颜色 ((如果配置) )。 用户无法在应用中还原此设置。 例如:New-LabelPolicy -Identity Global -AdvancedSettings @{HideBarByDefault="True"}

此外,对于 Power BI:

  • powerbimandatory:Power BI 的强制标记。 示例:New-LabelPolicy -Identity Global -AdvancedSettings @{powerbimandatory="true"}。 有关此配置选项的详细信息,请参阅 Power BI 的强制标签策略

  • powerbidefaultlabelid:Power BI 内容的默认标签。 示例:New-LabelPolicy -Identity Global -AdvancedSettings @{powerbidefaultlabelid="General"}。 有关此配置选项的详细信息,请参阅 Power BI 的默认标签策略

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

-ExchangeLocation

ExchangeLocation 参数指定要包含在策略中的邮箱。 有效值为邮箱。

若要指定邮箱,可以使用唯一标识邮箱的任何值。 例如:

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

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

-ExchangeLocationException

ExchangeLocationException 参数指定要在 ExchangeLocation 参数使用值 All 时排除的邮箱。 有效值为邮箱。

若要指定邮箱,可以使用唯一标识邮箱的任何值。 例如:

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

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

-Force

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

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

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

-Labels

Labels 参数指定与策略关联的敏感度标签。 可以使用唯一标识该标签的任何值。 例如:

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

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

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

-MigrationId

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

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

-ModernGroupLocation

ModernGroupLocation 参数指定要包含在策略中的Microsoft 365 组。 若要标识 Microsoft 365 组,必须使用主 SMTP 地址。

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

-ModernGroupLocationException

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

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

-Name

Name 参数指定策略的唯一名称。 最大长度为 64 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

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

-OneDriveLocation

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

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

-OneDriveLocationException

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

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

-PublicFolderLocation

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

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

-Setting

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

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

-Settings

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

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

-SharePointLocation

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

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

-SharePointLocationException

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

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

-SkypeLocation

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

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

-SkypeLocationException

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

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