Set-Label

模块:

ExchangePowerShell

适用于:

Security & Compliance

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

使用 “Set-Label” cmdlet 来修改组织中的敏感度标签。

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

语法

Set-Label
   [-Identity] <ComplianceRuleIdParameter>
   [-AdvancedSettings <PswsHashtable>]
   [-ApplyContentMarkingFooterAlignment <Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+ContentAlignment>]
   [-ApplyContentMarkingFooterEnabled <System.Boolean>]
   [-ApplyContentMarkingFooterFontColor <String>]
   [-ApplyContentMarkingFooterFontName <String>]
   [-ApplyContentMarkingFooterFontSize <System.Int32>]
   [-ApplyContentMarkingFooterMargin <System.Int32>]
   [-ApplyContentMarkingFooterText <String>]
   [-ApplyContentMarkingHeaderAlignment <Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+ContentAlignment>]
   [-ApplyContentMarkingHeaderEnabled <System.Boolean>]
   [-ApplyContentMarkingHeaderFontColor <String>]
   [-ApplyContentMarkingHeaderFontName <String>]
   [-ApplyContentMarkingHeaderFontSize <System.Int32>]
   [-ApplyContentMarkingHeaderMargin <System.Int32>]
   [-ApplyContentMarkingHeaderText <String>]
   [-ApplyDynamicWatermarkingEnabled <System.Boolean>]
   [-ApplyWaterMarkingEnabled <System.Boolean>]
   [-ApplyWaterMarkingFontColor <String>]
   [-ApplyWaterMarkingFontName <String>]
   [-ApplyWaterMarkingFontSize <System.Int32>]
   [-ApplyWaterMarkingLayout <Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+WaterMarkingLayout>]
   [-ApplyWaterMarkingText <String>]
   [-ColumnAssetCondition <String>]
   [-Comment <String>]
   [-Conditions <MultiValuedProperty>]
   [-Confirm]
   [-ContentType <MipLabelContentType>]
   [-DefaultContentLabel <String>]
   [-DisplayName <String>]
   [-DynamicWatermarkDisplay <String>]
   [-EncryptionContentExpiredOnDateInDaysOrNever <String>]
   [-EncryptionDoNotForward <System.Boolean>]
   [-EncryptionDoubleKeyEncryptionUrl <String>]
   [-EncryptionEnabled <System.Boolean>]
   [-EncryptionEncryptOnly <System.Boolean>]
   [-EncryptionOfflineAccessDays <System.Int32>]
   [-EncryptionPromptUser <System.Boolean>]
   [-EncryptionProtectionType <Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+SupportedProtectionType>]
   [-EncryptionRightsDefinitions <EncryptionRightsDefinitionsParameter>]
   [-EncryptionRightsUrl <String>]
   [-LabelActions <MultiValuedProperty>]
   [-LocaleSettings <MultiValuedProperty>]
   [-MigrationId <String>]
   [-NextLabel <ComplianceRuleIdParameter>]
   [-ParentId <ComplianceRuleIdParameter>]
   [-PreviousLabel <ComplianceRuleIdParameter>]
   [-Priority <System.Int32>]
   [-SchematizedDataCondition <String>]
   [-Setting <PswsHashtable>]
   [-Settings <PswsHashtable>]
   [-SiteAndGroupProtectionAllowAccessToGuestUsers <System.Boolean>]
   [-SiteAndGroupProtectionAllowEmailFromGuestUsers <System.Boolean>]
   [-SiteAndGroupProtectionAllowFullAccess <System.Boolean>]
   [-SiteAndGroupProtectionAllowLimitedAccess <System.Boolean>]
   [-SiteAndGroupProtectionBlockAccess <System.Boolean>]
   [-SiteAndGroupProtectionEnabled <System.Boolean>]
   [-SiteAndGroupProtectionLevel <SiteAndGroupProtectionLevelParameter>]
   [-SiteAndGroupProtectionPrivacy <Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+GroupProtectionPrivacy>]
   [-SiteExternalSharingControlType <Microsoft.Office.CompliancePolicy.Tasks.SiteExternalSharingControlType>]
   [-TeamsAllowedPresenters <Microsoft.Office.CompliancePolicy.PolicyConfiguration.AllowedPresenters>]
   [-TeamsAllowMeetingChat <Microsoft.Office.CompliancePolicy.PolicyConfiguration.MeetingChatMode>]
   [-TeamsAllowPrivateTeamsToBeDiscoverableUsingSearch <System.Boolean>]
   [-TeamsBypassLobbyForDialInUsers <System.Boolean>]
   [-TeamsChannelProtectionEnabled <System.Boolean>]
   [-TeamsChannelSharedWithExternalTenants <System.Boolean>]
   [-TeamsChannelSharedWithPrivateTeamsOnly <System.Boolean>]
   [-TeamsChannelSharedWithSameLabelOnly <System.Boolean>]
   [-TeamsCopyRestrictionEnforced <System.Boolean>]
   [-TeamsEndToEndEncryptionEnabled <System.Boolean>]
   [-TeamsLobbyBypassScope <Microsoft.Office.CompliancePolicy.PolicyConfiguration.LobbyBypassScope>]
   [-TeamsLobbyRestrictionEnforced <System.Boolean>]
   [-TeamsPresentersRestrictionEnforced <System.Boolean>]
   [-TeamsProtectionEnabled <System.Boolean>]
   [-TeamsRecordAutomatically <System.Boolean>]
   [-TeamsVideoWatermark <Microsoft.Office.CompliancePolicy.PolicyConfiguration.WaterMarkProtectionValues>]
   [-TeamsWhoCanRecord <Microsoft.Office.CompliancePolicy.PolicyConfiguration.WhoCanRecordOptions>]
   [-Tooltip <String>]
   [-WhatIf]
   [<CommonParameters>]

说明

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

示例

示例 1

Set-Label -Identity "Label1" -LocaleSettings '{"localeKey":"DisplayName","Settings":[{"Key":"en-us","Value":"English display name"},{"Key":"de-de","Value":"Deutscher Anzeigename"},{"Key":"es-es","Value":"Nombre para mostrar en Español"}]}','{"localeKey":"tooltip","Settings":[{"Key":"en-us","Value":"This is an example label"},{"Key":"de-de","Value":"Dies ist ein Beispieletikett"},{"Key":"es-es","Value":"Esta es una etiqueta de ejemplo"}]}'

本示例设置不同语言的“Label1”的本地化标签名称和标签工具提示， (英语、德语和西班牙语) 。

示例 2

Set-Label -Identity "Label1" -LocaleSettings '{"localeKey":"DisplayName","Settings":[{"Key":"en-us","Value":""},{"Key":"de-de","Value":""},{"Key":"es-es","Value":""}]}','{"localeKey":"tooltip","Settings":[{"Key":"en-us","Value":""},{"Key":"de-de","Value":""},{"Key":"es-es","Value":""}]}'

此示例删除不同语言的“Label1”的本地化标签名称和标签工具提示， (英语、德语和西班牙语) 。

参数

-AdvancedSettings

AdvancedSettings 参数为敏感度标签启用特定特性和功能。

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

使用此参数配置的某些设置仅受Microsoft Purview 信息保护客户端的支持，不支持支持内置标记的 Office 应用和服务。 有关这些设置的列表，请参阅 Microsoft Purview 信息保护 客户端的高级设置。

内置标签支持的设置：

• BlockContentAnalysisServices：指定隐私设置，以允许或阻止将 Word、Excel、PowerPoint 和 Outlook 中的内容发送到Microsoft进行内容分析。 可用值为 True，false (默认) 。 此设置会影响数据丢失防护策略提示、自动和建议标记以及 Microsoft 365 的Microsoft Copilot等服务。 示例：Set-Label -Identity Confidential -AdvancedSettings @{BlockContentAnalysisServices="True"}。 有关详细信息，请参阅 “阻止一些分析内容的连接体验”。

• 颜色：将标签颜色指定为红色、绿色和蓝色 (RGB) 组件的十六进制三元代码。 示例：Set-Label -Identity 8faca7b8-8d20-48a3-8ea2-0f96310a848e -AdvancedSettings @{color="#40e0d0"}。 有关详细信息，请参阅 使用 PowerShell 配置自定义颜色。

• DefaultSharingScope：指定标签范围包括组 &网站时网站的默认共享链接类型，指定标签范围包括文件 & 电子邮件时文档的默认共享链接类型。 可用值为 SpecificPeople、Organization 和任何人。 示例：Set-Label -Identity General -AdvancedSettings @{DefaultSharingScope="SpecificPeople"}。 有关详细信息，请参阅 使用敏感度标签为 SharePoint 和 OneDrive 中的网站和文档配置默认共享链接类型。

• DefaultShareLinkPermission：指定标签范围包括组 &网站时网站共享链接的权限，以及标签范围包括文件 & 电子邮件时文档共享链接的权限。 可用值为 View 和 Edit。 示例：Set-Label -Identity General -AdvancedSettings @{DefaultShareLinkPermission="Edit"}。 有关详细信息，请参阅 使用敏感度标签为 SharePoint 和 OneDrive 中的网站和文档配置默认共享链接类型。

• DefaultShareLinkToExistingAccess：指定是否替代 DefaultSharingScope 和 DefaultShareLinkPermission ，改为将默认共享链接类型设置为具有现有权限的现有访问权限的人员。 示例：Set-Label -Identity General -AdvancedSettings @{DefaultShareLinkToExistingAccess="True"}。 有关详细信息，请参阅 使用敏感度标签为 SharePoint 和 OneDrive 中的网站和文档配置默认共享链接类型。

• DefaultSubLabelId：指定当用户在 Office 应用中选择父标签时自动应用的默认子标签。 示例：Set-Label -Identity Confidential -AdvancedSettings @{DefaultSubLabelId="8faca7b8-8d20-48a3-8ea2-0f96310a848e"}。 有关详细信息，请参阅 为父标签指定默认子标签。

• MembersCanShare：对于容器标签，指定成员如何共享 SharePoint 网站。 可用值为 MemberShareAll、MemberShareFileAndFolder 和 MemberShareNone。 示例：Set-Label -Identity General -AdvancedSettings @{MembersCanShare="MemberShareFileAndFolder"}。 有关详细信息，请参阅 使用 PowerShell 高级设置配置网站共享权限。

• SMimeEncrypt：指定 Outlook 的 S/MIME 加密。 可用值为 True，false (默认) 。 示例：Set-Label -Identity "Confidential" -AdvancedSettings @{SMimeEncrypt="True"}。 有关详细信息，请参阅 配置标签以在 Outlook 中应用 S/MIME 保护。

• SMimeSign：指定 Outlook 的 S/MIME 数字签名。 可用值为 True，false (默认) 。 示例：Set-Label -Identity "Confidential" -AdvancedSettings @{SMimeSign="True"}。 有关详细信息，请参阅 配置标签以在 Outlook 中应用 S/MIME 保护。

有关帮助配置标签高级设置的详细信息，请参阅 用于指定高级设置的 PowerShell 提示。

类型:	PswsHashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyContentMarkingFooterAlignment

ApplyContentMarkingFooterAlignment 参数指定页脚对齐方式。 有效值包含:

• Left
• 居中
• Right

仅当 ApplyContentMarkingFooterEnabled 参数值$true或$false时，此参数才有意义。

类型:	Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+ContentAlignment
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyContentMarkingFooterEnabled

ApplyContentMarkingFooterEnabled 参数启用或禁用标签的“应用内容标记页脚”操作。 有效值包含:

• $true：已启用“应用内容标记页脚”操作。
• $false：禁用“应用内容标记页脚”操作。

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyContentMarkingFooterFontColor

ApplyContentMarkingFooterFontColor 参数指定页脚文本的颜色。 此参数接受格式 #xxxxxx为 的十六进制颜色代码值。 默认值为 #000000。

仅当 ApplyContentMarkingFooterEnabled 参数值$true或$false时，此参数才有意义。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyContentMarkingFooterFontName

ApplyContentMarkingFooterFontName 参数指定页脚文本的字体。 如果值中有空格，请使用双引号 (") 将此值括起来。 例如 "Courier New"。

仅当 ApplyContentMarkingFooterEnabled 参数值$true或$false时，此参数才有意义。

此参数仅受 Azure 信息保护统一标记客户端的支持，不支持支持内置标记的 Office 应用和服务。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyContentMarkingFooterFontSize

ApplyContentMarkingFooterFontSize 参数指定页脚文本 () 以磅为单位的字号。

仅当 ApplyContentMarkingFooterEnabled 参数值$true或$false时，此参数才有意义。

类型:	System.Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyContentMarkingFooterMargin

ApplyContentMarkingFooterMargin 参数指定页脚边距) 的大小 (以磅为单位。

仅当 ApplyContentMarkingFooterEnabled 参数值$true或$false时，此参数才有意义。

注意：在 Microsoft Word 和 PowerPoint 中，指定的值用作左对齐或右对齐内容标记的下边距和左边距或右边距。 最小值为 15 分。 Word还会向左对齐内容标记的左边距添加 5 磅的常量偏移量，或向右对齐内容标记的右边距添加 5 磅的固定偏移量。

类型:	System.Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyContentMarkingFooterText

ApplyContentMarkingFooterText 参数指定页脚文本。 如果值中有空格，请使用双引号 (") 将此值括起来。

仅当 ApplyContentMarkingFooterEnabled 参数值$true或$false时，此参数才有意义。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyContentMarkingHeaderAlignment

ApplyContentMarkingHeaderAlignment 参数指定标头对齐方式。 有效值包含:

• Left
• 居中
• Right

仅当 ApplyContentMarkingHeaderEnabled 参数值$true或$false时，此参数才有意义。

类型:	Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+ContentAlignment
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyContentMarkingHeaderEnabled

ApplyContentMarkingHeaderEnabled 参数启用或禁用标签的“应用内容标记标头”操作。 有效值包含:

• $true：已启用“应用内容标记标头”操作。
• $false：禁用“应用内容标记标头”操作。

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyContentMarkingHeaderFontColor

ApplyContentMarkingHeaderFontColor 参数指定标题文本的颜色。 此参数接受格式 #xxxxxx为 的十六进制颜色代码值。 默认值为 #000000。

仅当 ApplyContentMarkingHeaderEnabled 参数值$true或$false时，此参数才有意义。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyContentMarkingHeaderFontName

ApplyContentMarkingHeaderFontName 参数指定标题文本的字体。 如果值中有空格，请使用双引号 (") 将此值括起来。 例如 "Courier New"。

仅当 ApplyContentMarkingHeaderEnabled 参数值$true或$false时，此参数才有意义。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyContentMarkingHeaderFontSize

ApplyContentMarkingHeaderFontSize 参数指定标题文本) (字号。

仅当 ApplyContentMarkingHeaderEnabled 参数值$true或$false时，此参数才有意义。

类型:	System.Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyContentMarkingHeaderMargin

ApplyContentMarkingHeaderMargin 参数指定标题边距的大小 (以磅为单位) 。

仅当 ApplyContentMarkingHeaderEnabled 参数值$true或$false时，此参数才有意义。

注意：在 Microsoft Word 和 PowerPoint 中，指定的值用作左对齐或右对齐内容标记的上边距和左边距或右边距。 最小值为 15 分。 Word还会向左对齐内容标记的左边距添加 5 磅的常量偏移量，或向右对齐内容标记的右边距添加 5 磅的固定偏移量。

类型:	System.Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyContentMarkingHeaderText

ApplyContentMarkingHeaderText 参数指定标头文本。 如果值中有空格，请使用双引号 (") 将此值括起来。

仅当 ApplyContentMarkingHeaderEnabled 参数值$true或$false时，此参数才有意义。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyDynamicWatermarkingEnabled

注意：此参数目前为公共预览版，并非在所有组织中都可用，并且可能会发生更改。

ApplyDynamicWatermarkingEnabled 参数为应用加密的特定标签启用动态水印。 有效值包含:

• $true：为特定标签启用动态水印。
• $false：禁用特定标签的动态水印。

使用 DynamicWatermarkDisplay 参数设置水印文本。 有关对支持的应用使用动态水印的详细信息，请参阅 动态水印。

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyWaterMarkingEnabled

ApplyWaterMarkingEnabled 参数启用或禁用标签的“应用水印标头”操作。 有效值包含:

• $true：已启用“应用水印标头”操作。
• $false：禁用“应用水印标头”操作。

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyWaterMarkingFontColor

ApplyWaterMarkingFontColor 参数指定水印文本的颜色。 此参数接受格式 #xxxxxx为 的十六进制颜色代码值。 默认值为 #000000。

仅当 ApplyWaterMarkingEnabled 参数值$true或$false时，此参数才有意义。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyWaterMarkingFontName

ApplyWaterMarkingFontName 参数指定水印文本的字体。 如果值中有空格，请使用双引号 (") 将此值括起来。 例如 "Courier New"。

仅当 ApplyWaterMarkingEnabled 参数值$true或$false时，此参数才有意义。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyWaterMarkingFontSize

ApplyWaterMarkingFontSize 参数指定字号 () 水印文本的磅数。

仅当 ApplyWaterMarkingEnabled 参数值$true或$false时，此参数才有意义。

类型:	System.Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyWaterMarkingLayout

ApplyWaterMarkingLayout 参数指定水印对齐方式。 有效值包含:

• 水平
• 对角线

仅当 ApplyWaterMarkingEnabled 参数值$true或$false时，此参数才有意义。

类型:	Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+WaterMarkingLayout
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ApplyWaterMarkingText

ApplyWaterMarkingText 参数指定水印文本。 如果值中有空格，请使用双引号 (") 将此值括起来。

仅当 ApplyWaterMarkingEnabled 参数值$true或$false时，此参数才有意义。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ColumnAssetCondition

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-Comment

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-Conditions

Conditions 参数用于自动标记正在使用的数据的文件和电子邮件。

类型:	MultiValuedProperty
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-Confirm

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

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ContentType

ContentType 参数指定可在何处应用敏感度标签。 有效值包含:

• 文件
• 电子邮件
• Site
• UnifiedGroup
• PurviewAssets
• 团队合作
• SchematizedData

可以组合值，例如：“File，Email，PurviewAssets”。

类型:	MipLabelContentType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-DefaultContentLabel

DefaultContentLabel 指定一个标签，该标签可自动应用于在已标记的 Teams 频道中创建的会议。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-DisplayName

DisplayName 参数指定了敏感度标签的显示名称。 显示名称显示在支持敏感度标签的任何客户端中。 这包括 Word、Excel、PowerPoint、Outlook、SharePoint、Teams 和 Power BI。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-DynamicWatermarkDisplay

注意：此参数目前为公共预览版，并非在所有组织中都可用，并且可能会发生更改。

DynamicWatermarkDisplay 参数指定要为给定标签显示的水印文本。 此参数支持文本和以下特殊标记：

• “'${Consumer.PrincipalName}”：必需。 该值是用户 UPN) (用户主体名称。
• “'${Device.DateTime}”：可选。 该值是用于查看文档的设备当前日期/时间。

提示 在 PowerShell 中， ( ' ) 作为美元符号字符 ( $ ) 的转义符是必需的。 有关详细信息，请参阅 Exchange PowerShell 中的转义字符。

仅当 ApplyDynamicWatermarkingEnabled 参数值$true时，此参数才有意义。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-EncryptionContentExpiredOnDateInDaysOrNever

EncryptionContentExpiredOnDateInDaysOrNever 参数指定加密内容何时过期。 有效值包含:

• 一个整数 (天数)
• 值 Never

仅当 EncryptionEnabled 参数值$true或$false时，此参数才有意义。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-EncryptionDoNotForward

EncryptionDoNotForward 参数指定是否应用“不转发”模板。 有效值包含:

• $true：应用“请勿转发”模板。
• $false：不应用“不转发”模板。

仅当 EncryptionEnabled 参数值$true或$false时，此参数才有意义。

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-EncryptionDoubleKeyEncryptionUrl

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-EncryptionEnabled

EncryptionEnabled 参数指定是否已启用加密。 有效值包含:

• $true：已启用加密。
• $false：加密已禁用。

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-EncryptionEncryptOnly

EncryptionEncryptOnly 参数指定是否应用仅加密模板。 有效值包含:

• $true：应用仅加密模板。
• $false：不应用仅加密模板。

仅当 EncryptionEnabled 参数值$true或$false时，此参数才有意义。

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-EncryptionOfflineAccessDays

EncryptionOfflineAccessDays 参数指定允许脱机访问的天数。

仅当 EncryptionEnabled 参数值$true或$false时，此参数才有意义。

类型:	System.Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-EncryptionPromptUser

EncryptionPromptUser 参数指定是否在 Word、Excel 和 PowerPoint 中使用用户定义的权限设置标签。 有效值包含:

• $true：标签在 Word、Excel 和 PowerPoint 中使用用户定义的权限进行设置。
• $false：未在 Word、Excel 和 PowerPoint 中使用用户定义的权限设置标签。

仅当 EncryptionEnabled 参数值$true或$false且 EncryptionProtectionType 参数值为 UserDefined 时，此参数才有意义。

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-EncryptionProtectionType

EncryptionProtectionType 参数指定加密的保护类型。 有效值包含:

• 模板
• RemoveProtection
• 用户定义

仅当 EncryptionEnabled 参数值$true或$false时，此参数才有意义。

类型:	Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+SupportedProtectionType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-EncryptionRightsDefinitions

EncryptionRightsDefinitions 参数指定用户在访问受保护时拥有的权限。 此参数使用语法 Identity1:Rights1,Rights2;Identity2:Rights3,Rights4。 例如，john@contoso.com:VIEW,EDIT;microsoft.com:VIEW。

仅当 EncryptionEnabled 参数值为 $true 或 $false 且 EncryptionProtectionType 参数值为 Template 时，此参数才有意义。

类型:	EncryptionRightsDefinitionsParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-EncryptionRightsUrl

EncryptionRightsUrl 参数指定用于保存自己的密钥的 URL， (HYOK) 保护。

仅当 EncryptionEnabled 参数值$true或$false时，此参数才有意义。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-Identity

Identity 参数指定要修改的敏感度标签。 可以使用唯一标识该标签的任何值。 例如：

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

类型:	ComplianceRuleIdParameter
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False
适用于:	Security & Compliance

-LabelActions

LabelActions 参数用于指定可以对标签执行的操作。

类型:	MultiValuedProperty
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-LocaleSettings

LocaleSettings 参数指定一个或多个不同语言的本地化标签名称和标签工具提示。 区域包括 Office Clien t应用程序中支持的所有区域代码。 有效的值采用以下语法（JSON）：

• 标签显示名称： {"localeKey":"DisplayName","Settings":[{"Key":"en-us","Value":"English display name"},{"Key":"de-de","Value":"Deutscher Anzeigename"},{"Key":"es-es","Value":"Nombre para mostrar en Español"}]}
• 标签工具提示： {"localeKey":"Tooltip","Settings":[{"Key":"en-us","Value":"English Tooltip"},{"Key":"de-de","Value":"Deutscher Tooltip"},{"Key":"es-es","Value":"Tooltip Español"}]}

若要删除语言，需要为该语言输入空值。

类型:	MultiValuedProperty
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-MigrationId

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-NextLabel

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

类型:	ComplianceRuleIdParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-ParentId

ParentId 参数指定了此标签（子标签）位于其下方的父标签。 可以使用唯一标识该父敏感度标签的任何值。 例如：

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

类型:	ComplianceRuleIdParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-PreviousLabel

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

类型:	ComplianceRuleIdParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-Priority

“Priority” 参数指定敏感度标签的​​优先级值，该优先级值确定标签处理的顺序。 较高的整数值表示更高的优先级。

类型:	System.Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-SchematizedDataCondition

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-Setting

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

类型:	PswsHashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-Settings

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

类型:	PswsHashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-SiteAndGroupProtectionAllowAccessToGuestUsers

SiteAndGroupProtectionAllowAccessToGuestUsers 参数启用或禁用对来宾用户的访问权限。 有效值包含:

• $true：启用来宾访问。
• $false：来宾访问已禁用。

仅当 SiteAndGroupProtectionEnabled 参数值$true或$false时，此参数才有意义。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-SiteAndGroupProtectionAllowEmailFromGuestUsers

SiteAndGroupProtectionAllowEmailFromGuestUsers 参数启用或禁用来自来宾用户的电子邮件。 有效值包含:

• $true：已启用来宾用户的Email。
• $false：禁用来宾用户的Email。

仅当 SiteAndGroupProtectionEnabled 参数值$true或$false时，此参数才有意义。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-SiteAndGroupProtectionAllowFullAccess

SiteAndGroupProtectionAllowFullAccess 参数启用或禁用完全访问权限。 有效值包含:

• $true：已启用完全访问权限。
• $false：禁用完全访问权限。

仅当 SiteAndGroupProtectionEnabled 参数值$true或$false时，此参数才有意义。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-SiteAndGroupProtectionAllowLimitedAccess

SiteAndGroupProtectionAllowLimitedAccess 参数启用或禁用受限访问。 有效值包含:

• $true：启用受限访问。
• $false：禁用受限访问。

仅当 SiteAndGroupProtectionEnabled 参数值$true或$false时，此参数才有意义。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-SiteAndGroupProtectionBlockAccess

SiteAndGroupProtectionBlockAccess 参数阻止访问。 有效值包含:

• $true：访问被阻止。
• $false：允许访问。

仅当 SiteAndGroupProtectionEnabled 参数值$true或$false时，此参数才有意义。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-SiteAndGroupProtectionEnabled

SiteAndGroupProtectionEnabled 参数启用或禁用标签的“站点和组保护”操作。 有效值包含:

• $true：已启用站点和组保护操作。
• $false：站点和组保护操作已禁用。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-SiteAndGroupProtectionLevel

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

类型:	SiteAndGroupProtectionLevelParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-SiteAndGroupProtectionPrivacy

SiteAndGroupProtectionPrivacy 参数指定实验室的隐私级别。 有效值包含:

• 公开
• Private

仅当 SiteAndGroupProtectionEnabled 参数值$true或$false时，此参数才有意义。

类型:	Microsoft.Office.CompliancePolicy.PolicyConfiguration.AccessType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-SiteExternalSharingControlType

SiteExternalSharingControlType 参数指定标签的外部用户共享设置。 有效值包含:

• ExternalUserAndGuestSharing
• ExternalUserSharingOnly
• ExistingExternalUserSharingOnly
• Disabled

这些设置对应于通过管理中心进行的以下设置：

• 任何人
• 新来宾和现有来宾
• 现有来宾
• 仅限所在组织中的人员

类型:	Microsoft.Office.CompliancePolicy.Tasks.SiteExternalSharingControlType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsAllowedPresenters

TeamsAllowedPresenters 参数控制谁可以在 Teams 会议中演示。 有效值包含:

• 所有人
• 组织
• 组织者
• RoleIsPresenter
• $null (空白) ：用户在 Teams 应用中自行配置此设置。

类型:	Microsoft.Office.CompliancePolicy.PolicyConfiguration.AllowedPresenters
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsAllowMeetingChat

TeamsAllowMeetingChat 参数控制聊天在 Teams 会议中是否可用。 有效值包含:

• 已启用
• Disabled
• 受限：聊天仅在通话期间可用。
• $null (空白) ：用户在 Teams 应用中自行配置此设置。

类型:	Microsoft.Office.CompliancePolicy.PolicyConfiguration.MeetingChatMode
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsAllowPrivateTeamsToBeDiscoverableUsingSearch

{{ Fill TeamsAllowPrivateTeamsToBeDiscoverableUsingSearch Description }}

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsBypassLobbyForDialInUsers

TeamsBypassLobbyForDialInUsers 参数控制加入 Teams 会议的拨入用户的大厅体验。 有效值包含:

• $true：在加入 Teams 会议时，拨入用户绕过大厅。
• $false：在加入 Teams 会议时，拨入用户不会绕过大厅。
• $null (空白) ：用户在 Teams 应用中自行配置此设置。

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsChannelProtectionEnabled

{{ Fill TeamsChannelProtectionEnabled Description }}

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsChannelSharedWithExternalTenants

{{ Fill TeamsChannelSharedWithExternalTenants Description }}

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsChannelSharedWithPrivateTeamsOnly

{{ Fill TeamsChannelSharedWithPrivateTeamsOnly Description }}

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsChannelSharedWithSameLabelOnly

{{ Fill TeamsChannelSharedWithSameLabelOnly Description }}

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsCopyRestrictionEnforced

TeamsCopyRestrictionEnforced 参数控制是否可以将 Teams 会议中的聊天消息复制到剪贴板。 有效值包含:

• $true：可将聊天消息复制到剪贴板。
• $false：无法将聊天消息复制到剪贴板。

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsEndToEndEncryptionEnabled

TeamsEndToEndEncryptionEnabled 参数控制 Teams 会议中的视频流加密。 有效值包含:

• $true：已启用视频流加密。
• $false：未启用视频流加密。
• $null (空白) ：用户在 Teams 应用中自行配置此设置。

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsLobbyBypassScope

TeamsLobbyBypassScope 参数控制谁在加入 Teams 会议时绕过大厅。 有效值包含:

• 所有人
• 邀请
• 组织
• OrganizationAndFederated
• OrganizationExcludingGuests
• 组织者
• $null (空白) ：用户在 Teams 应用中自行配置此设置。

类型:	Microsoft.Office.CompliancePolicy.PolicyConfiguration.LobbyBypassScope
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsLobbyRestrictionEnforced

TeamsLobbyRestrictionEnforced 参数控制参与者在加入 Teams 会议时是否绕过大厅。 有效值包含:

• $true：用户在加入 Teams 会议时绕过大厅。
• $false：用户在加入 Teams 会议时不会绕过大厅。
• $null (空白) ：用户在 Teams 应用中自行配置此设置。

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsPresentersRestrictionEnforced

TeamsPresentersRestrictionEnforced 参数控制是否在 Teams 会议中启用演示者限制。 有效值包含:

• $true：Teams 会议中启用了演示者限制。
• $false：Teams 会议中未启用演示者限制。
• $null (空白) ：用户在 Teams 应用中自行配置此设置。

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsProtectionEnabled

TeamsProtectionEnabled 参数控制是否在 Teams 会议中启用 Teams 保护。 有效值包含:

• $true：Teams 会议中启用了 Teams 保护。
• $false：Teams 会议中未启用 Teams 保护。

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsRecordAutomatically

TeamsRecordAutomatically 参数控制 Teams 会议在启动后是否自动录制。 有效值包含:

• $true：Teams 会议在启动后自动录制。
• $false：Teams 会议不会自动录制。
• $null (空白) ：用户在 Teams 应用中自行配置此设置。

类型:	System.Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsVideoWatermark

TeamsVideoWatermark 参数控制是否在 Teams 会议中显示水印。 有效值包含:

• None
• EnabledForContentSharing
• EnabledForVideo
• $null (空白) ：用户在 Teams 应用中自行配置此设置。

类型:	Microsoft.Office.CompliancePolicy.PolicyConfiguration.WaterMarkProtectionValues
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-TeamsWhoCanRecord

TeamsWhoCanRecord 参数控制谁可以录制 Teams 会议。 有效值包含:

• 组织者
• Coorganizers
• Presenters
• $null (空白) ：用户在 Teams 应用中自行配置此设置。

类型:	Microsoft.Office.CompliancePolicy.PolicyConfiguration.WhoCanRecordOptions
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-Tooltip

ToolTip 参数指定用户可看到的默认工具提示和敏感度标签描述。 如果值中有空格，请使用双引号 (") 将此值括起来。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

-WhatIf

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

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Security & Compliance

相关链接

• New-Label