New-Label

模块:

ExchangePowerShell

适用于:

Security & Compliance

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

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

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

语法

New-Label
   [-Name] <String>
   -DisplayName <String>
   -Tooltip <String>
   [-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>]
   [-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>]
   [-EncryptionAipTemplateScopes <String>]
   [-EncryptionContentExpiredOnDateInDaysOrNever <String>]
   [-EncryptionDoNotForward <System.Boolean>]
   [-EncryptionDoubleKeyEncryptionUrl <String>]
   [-EncryptionEnabled <System.Boolean>]
   [-EncryptionEncryptOnly <System.Boolean>]
   [-EncryptionLinkedTemplateId <String>]
   [-EncryptionOfflineAccessDays <System.Int32>]
   [-EncryptionPromptUser <System.Boolean>]
   [-EncryptionProtectionType <Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+SupportedProtectionType>]
   [-EncryptionRightsDefinitions <EncryptionRightsDefinitionsParameter>]
   [-EncryptionRightsUrl <String>]
   [-EncryptionTemplateId <String>]
   [-Identity <MasterIdParameter>]
   [-LabelActions <MultiValuedProperty>]
   [-LocaleSettings <MultiValuedProperty>]
   [-MigrationId <String>]
   [-ParentId <ComplianceRuleIdParameter>]
   [-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>]
   [-WhatIf]
   [<CommonParameters>]

说明

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

示例

示例 1

New-Label -DisplayName "My New label" -Name "New Label"

本示例创建一个名为“新标签”的新标签，其显示名称为“我的新标签”。

参数

-AdvancedSettings

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

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

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

内置标签支持的设置：

• 颜色：将标签颜色指定为红色、绿色和蓝色 (RGB) 组件的十六进制三元代码。 示例：New-Label -DisplayName "General" -Name "General" -Tooltip "Business data that is not intended for public consumption." -AdvancedSettings @{color="#40e0d0"}。 有关详细信息，请参阅 使用 PowerShell 配置自定义颜色。

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

• DefaultShareLinkPermission：指定标签范围包括组&网站时网站共享链接的权限，指定标签范围包括文件&电子邮件时文档共享链接的权限。 可用值为 View 和 Edit。 示例：New-Label DisplayName "General" -Name "General" -Tooltip "Business data that is not intended for public consumption." -AdvancedSettings @{DefaultShareLinkPermission="Edit"}。 有关详细信息，请参阅 使用敏感度标签为 SharePoint 和 OneDrive 中的网站和文档配置默认共享链接类型。

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

• DefaultSubLabelId：指定当用户在 Office 应用中选择父标签时自动应用的默认子标签。 示例：New-Label -DisplayName "Confidential" -Name "Confidential" -Tooltip "Confidential data that requires protection, which allows all employees full permissions. Data owners can track and revoke content." -AdvancedSettings @{DefaultSubLabelId="8faca7b8-8d20-48a3-8ea2-0f96310a848e"}。 有关详细信息，请参阅 为父标签指定默认子标签。

• MembersCanShare：对于容器标签，指定成员如何共享 SharePoint 网站。 可用值为 MemberShareAll、MemberShareFileAndFolder 和 MemberShareNone。 示例：New-Label -DisplayName "General" -Name "General" -Tooltip "Business data that is not intended for public consumption." -AdvancedSettings @{MembersCanShare="MemberShareFileAndFolder"}。 有关详细信息，请参阅 使用 PowerShell 高级设置配置网站共享权限。

• SMimeEncrypt：指定 Outlook 的 S/MIME 加密。 可用值为 True，false (默认) 。 示例：New-Label DisplayName "Confidential" -Name "Confidential" -Tooltip "Sensitive business data that could cause damage to the business if shared with unauthorized people." -AdvancedSettings @{SMimeEncrypt="True"}。 有关详细信息，请参阅 配置标签以在 Outlook 中应用 S/MIME 保护。

• SMimeSign：指定 Outlook 的 S/MIME 数字签名。 可用值为 True，false (默认) 。 示例：New-Label DisplayName "Confidential" -Name "Confidential" -Tooltip "Sensitive business data that could cause damage to the business if shared with unauthorized people." -AdvancedSettings @{SMimeSign="True"}。 有关详细信息，请参阅 配置标签以在 Outlook 中应用 S/MIME 保护。

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

-ApplyContentMarkingFooterAlignment

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

• Left
• 居中
• Right

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

Type:	Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+ContentAlignment
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ApplyContentMarkingFooterEnabled

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

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

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

-ApplyContentMarkingFooterFontColor

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

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

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

-ApplyContentMarkingFooterFontName

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

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

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

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

-ApplyContentMarkingFooterFontSize

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

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

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

-ApplyContentMarkingFooterMargin

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

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

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

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

-ApplyContentMarkingFooterText

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

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

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

-ApplyContentMarkingHeaderAlignment

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

• Left
• 居中
• Right

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

Type:	Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+ContentAlignment
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ApplyContentMarkingHeaderEnabled

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

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

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

-ApplyContentMarkingHeaderFontColor

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

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

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

-ApplyContentMarkingHeaderFontName

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

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

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

-ApplyContentMarkingHeaderFontSize

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

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

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

-ApplyContentMarkingHeaderMargin

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

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

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

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

-ApplyContentMarkingHeaderText

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

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

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

-ApplyWaterMarkingEnabled

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

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

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

-ApplyWaterMarkingFontColor

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

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

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

-ApplyWaterMarkingFontName

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

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

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

-ApplyWaterMarkingFontSize

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

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

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

-ApplyWaterMarkingLayout

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

• 水平
• 对角线

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

Type:	Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+WaterMarkingLayout
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ApplyWaterMarkingText

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

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

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

-ColumnAssetCondition

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

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

-Conditions

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

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

-ContentType

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

• 文件
• 电子邮件
• Site
• UnifiedGroup
• PurviewAssets
• Teamwork
• SchematizedData

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

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

-DefaultContentLabel

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

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

-DisplayName

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

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

-EncryptionAipTemplateScopes

EncryptionAipTemplateScopes 参数指定标签仍可在 AIP 经典客户端中发布和使用。 示例值为 "['allcompany@labelaction.onmicrosoft.com','admin@labelaction.onmicrosoft.com']"。

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

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

-EncryptionContentExpiredOnDateInDaysOrNever

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

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

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

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

-EncryptionDoNotForward

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

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

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

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

-EncryptionDoubleKeyEncryptionUrl

此参数的功能目前为公共预览版，并非所有人都可用。

EncryptionDoubleKeyEncryptionUrl 参数指定双密钥加密终结点 URL。

创建标签后，无法删除 URL;只能对其进行修改。

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

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

-EncryptionEnabled

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

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

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

-EncryptionEncryptOnly

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

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

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

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

-EncryptionLinkedTemplateId

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

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

-EncryptionOfflineAccessDays

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

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

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

-EncryptionPromptUser

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

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

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

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

-EncryptionProtectionType

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

• 模板
• RemoveProtection
• 用户定义

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

Type:	Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+SupportedProtectionType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-EncryptionRightsDefinitions

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

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

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

-EncryptionRightsUrl

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

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

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

-EncryptionTemplateId

EncryptionTemplateId 参数允许将现有保护模板从 Azure 信息保护 转换为新的敏感度标签。 通过从 AIPService PowerShell 模块运行 Get-AipServiceTemplate cmdlet 来指定模板的 ID。

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

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

-Identity

Identity 参数用于通过指定 GUID 值来迁移现有的 Azure 信息保护标签。

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

-LabelActions

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

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

-LocaleSettings

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

• 标签显示名称： {"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"}]}

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

-Name

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

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

-ParentId

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

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

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

-SchematizedDataCondition

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

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

-SiteAndGroupProtectionAllowAccessToGuestUsers

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

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

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

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

-SiteAndGroupProtectionAllowEmailFromGuestUsers

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

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

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

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

-SiteAndGroupProtectionAllowFullAccess

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

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

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

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

-SiteAndGroupProtectionAllowLimitedAccess

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

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

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

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

-SiteAndGroupProtectionBlockAccess

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

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

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

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

-SiteAndGroupProtectionEnabled

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

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

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

-SiteAndGroupProtectionLevel

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

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

-SiteAndGroupProtectionPrivacy

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

• 公开
• Private

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

Type:	Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+GroupProtectionPrivacy
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-SiteExternalSharingControlType

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

• ExternalUserAndGuestSharing
• ExternalUserSharingOnly
• ExistingExternalUserSharingOnly
• Disabled

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

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

Type:	Microsoft.Office.CompliancePolicy.Tasks.SiteExternalSharingControlType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-TeamsAllowedPresenters

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

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

Type:	Microsoft.Office.CompliancePolicy.PolicyConfiguration.AllowedPresenters
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-TeamsAllowMeetingChat

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

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

Type:	Microsoft.Office.CompliancePolicy.PolicyConfiguration.MeetingChatMode
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-TeamsAllowPrivateTeamsToBeDiscoverableUsingSearch

{{ Fill TeamsAllowPrivateTeamsToBeDiscoverableUsingSearch Description }}

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

-TeamsBypassLobbyForDialInUsers

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

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

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

-TeamsChannelProtectionEnabled

{{ Fill TeamsChannelProtectionEnabled Description }}

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

-TeamsChannelSharedWithExternalTenants

{{ Fill TeamsChannelSharedWithExternalTenants Description }}

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

-TeamsChannelSharedWithPrivateTeamsOnly

{{ Fill TeamsChannelSharedWithPrivateTeamsOnly Description }}

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

-TeamsChannelSharedWithSameLabelOnly

{{ Fill TeamsChannelSharedWithSameLabelOnly Description }}

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

-TeamsCopyRestrictionEnforced

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

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

值$null (空白) 允许用户在 Teams 应用中配置此设置。

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

-TeamsEndToEndEncryptionEnabled

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

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

值$null (空白) 允许用户在 Teams 应用中配置此设置。

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

-TeamsLobbyBypassScope

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

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

Type:	Microsoft.Office.CompliancePolicy.PolicyConfiguration.LobbyBypassScope
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-TeamsLobbyRestrictionEnforced

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

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

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

-TeamsPresentersRestrictionEnforced

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

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

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

-TeamsProtectionEnabled

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

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

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

-TeamsRecordAutomatically

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

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

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

-TeamsVideoWatermark

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

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

Type:	Microsoft.Office.CompliancePolicy.PolicyConfiguration.WaterMarkProtectionValues
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-TeamsWhoCanRecord

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

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

Type:	Microsoft.Office.CompliancePolicy.PolicyConfiguration.WhoCanRecordOptions
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Tooltip

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

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