Set-Label
This cmdlet is available only in Security & Compliance PowerShell. For more information, see Security & Compliance PowerShell.
Use the Set-Label cmdlet to modify sensitivity labels in your organization.
For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.
Syntax
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>]
Description
To use this cmdlet in Security & Compliance PowerShell, you need to be assigned permissions. For more information, see Permissions in the Microsoft Purview compliance portal.
Examples
Example 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"}]}'
This example sets the localized label name and label Tooltips for "Label1" in different languages (English, German, and Spanish).
Example 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":""}]}'
This example removes the localized label name and label Tooltips for "Label1" in different languages (English, German, and Spanish).
Parameters
-AdvancedSettings
The AdvancedSettings parameter enables specific features and capabilities for a sensitivity label.
Specify this parameter with the identity (name or GUID) of the sensitivity label, with key/value pairs in a hash table. To remove an advanced setting, use the same AdvancedSettings parameter syntax, but specify a null string value.
Some of the settings that you configure with this parameter are supported only by the Microsoft Purview Information Protection client and not by Office apps and services that support built-in labeling. For a list of these, see Advanced settings for Microsoft Purview Information Protection client.
Supported settings for built-in labeling:
BlockContentAnalysisServices: Specifies a privacy setting to allow or prevent content in Word, Excel, PowerPoint, and Outlook from being sent to Microsoft for content analysis. Available values are True, and False (the default). This setting impacts services such as data loss prevention policy tips, automatic and recommended labeling, and Microsoft Copilot for Microsoft 365. Example:
Set-Label -Identity Confidential -AdvancedSettings @{BlockContentAnalysisServices="True"}
. For more information, see Prevent some connected experiences that analyze content.Color: Specifies a label color as a hex triplet code for the red, green, and blue (RGB) components of the color. Example:
Set-Label -Identity 8faca7b8-8d20-48a3-8ea2-0f96310a848e -AdvancedSettings @{color="#40e0d0"}
. For more information, see Configuring custom colors by using PowerShell.DefaultSharingScope: Specifies the default sharing link type for a site when the label scope includes Groups & sites, and the default sharing link type for a document when the label scope includes Files & emails. Available values are SpecificPeople, Organization, and Anyone. Example:
Set-Label -Identity General -AdvancedSettings @{DefaultSharingScope="SpecificPeople"}
. For more information, see Use sensitivity labels to configure the default sharing link type for sites and documents in SharePoint and OneDrive.DefaultShareLinkPermission: Specifies the permissions for the sharing link for a site when the label scope includes Groups & sites, and the permissions for the sharing link for a document when the label scope includes Files & emails. Available values are View and Edit. Example:
Set-Label -Identity General -AdvancedSettings @{DefaultShareLinkPermission="Edit"}
. For more information, see Use sensitivity labels to configure the default sharing link type for sites and documents in SharePoint and OneDrive.DefaultShareLinkToExistingAccess: Specifies whether to override DefaultSharingScope and DefaultShareLinkPermission to instead set the default sharing link type to people with existing access with their existing permissions. Example:
Set-Label -Identity General -AdvancedSettings @{DefaultShareLinkToExistingAccess="True"}
. For more information, see Use sensitivity labels to configure the default sharing link type for sites and documents in SharePoint and OneDrive.DefaultSubLabelId: Specifies a default sublabel to be applied automatically when a user selects a parent label in Office apps. Example:
Set-Label -Identity Confidential -AdvancedSettings @{DefaultSubLabelId="8faca7b8-8d20-48a3-8ea2-0f96310a848e"}
. For more information, see Specify a default sublabel for a parent label.MembersCanShare: For a container label, specifies how members can share for a SharePoint site. Available values are MemberShareAll, MemberShareFileAndFolder, and MemberShareNone. Example:
Set-Label -Identity General -AdvancedSettings @{MembersCanShare="MemberShareFileAndFolder"}
. For more information, see Configure site sharing permissions by using PowerShell advanced settings.SMimeEncrypt: Specifies S/MIME encryption for Outlook. Available values are True, and False (the default). Example:
Set-Label -Identity "Confidential" -AdvancedSettings @{SMimeEncrypt="True"}
. For more information, see Configure a label to apply S/MIME protection in Outlook.SMimeSign: Specifies S/MIME digital signature for Outlook. Available values are True, and False (the default). Example:
Set-Label -Identity "Confidential" -AdvancedSettings @{SMimeSign="True"}
. For more information, see Configure a label to apply S/MIME protection in Outlook.
For more information to help you configure advanced settings for a label, see PowerShell tips for specifying the advanced settings.
Type: | PswsHashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyContentMarkingFooterAlignment
The ApplyContentMarkingFooterAlignment parameter specifies the footer alignment. Valid values are:
- Left
- Center
- Right
This parameter is meaningful only when the ApplyContentMarkingFooterEnabled parameter value is either $true or $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
The ApplyContentMarkingFooterEnabled parameter enables or disables the Apply Content Marking Footer action for the label. Valid values are:
- $true: The Apply Content Marking Footer action is enabled.
- $false: The Apply Content Marking Footer action is disabled.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyContentMarkingFooterFontColor
The ApplyContentMarkingFooterFontColor parameter specifies the color of the footer text. This parameter accepts a hexadecimal color code value in the format #xxxxxx
. The default value is #000000
.
This parameter is meaningful only when the ApplyContentMarkingFooterEnabled parameter value is either $true or $false.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyContentMarkingFooterFontName
The ApplyContentMarkingFooterFontName parameter specifies the font of the footer text. If the value contains spaces, enclose the value in quotation marks ("). For example "Courier New"
.
This parameter is meaningful only when the ApplyContentMarkingFooterEnabled parameter value is either $true or $false.
This parameter is supported only by the Azure Information Protection unified labeling client and not by Office apps and services that support built-in labeling.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyContentMarkingFooterFontSize
The ApplyContentMarkingFooterFontSize parameter specifies the font size (in points) of the footer text.
This parameter is meaningful only when the ApplyContentMarkingFooterEnabled parameter value is either $true or $false.
Type: | System.Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyContentMarkingFooterMargin
The ApplyContentMarkingFooterMargin parameter specifies the size (in points) of the footer margin.
This parameter is meaningful only when the ApplyContentMarkingFooterEnabled parameter value is either $true or $false.
Note: In Microsoft Word, the specified value is used as a bottom margin and left margin or right margin for left-aligned or right-aligned content marks. A minimum value of 15 points is required. Word also adds a constant offset of 5 points to the left margin for left-aligned content marks, or to the right margin for right-aligned content marks.
Type: | System.Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyContentMarkingFooterText
The ApplyContentMarkingFooterText parameter specifies the footer text. If the value contains spaces, enclose the value in quotation marks (").
This parameter is meaningful only when the ApplyContentMarkingFooterEnabled parameter value is either $true or $false.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyContentMarkingHeaderAlignment
The ApplyContentMarkingHeaderAlignment parameter specifies the header alignment. Valid values are:
- Left
- Center
- Right
This parameter is meaningful only when the ApplyContentMarkingHeaderEnabled parameter value is either $true or $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
The ApplyContentMarkingHeaderEnabled parameter enables or disables the Apply Content Marking Header action for the label. Valid values are:
- $true: The Apply Content Marking Header action is enabled.
- $false: The Apply Content Marking Header action is disabled.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyContentMarkingHeaderFontColor
The ApplyContentMarkingHeaderFontColor parameter specifies the color of the header text. This parameter accepts a hexadecimal color code value in the format #xxxxxx
. The default value is #000000
.
This parameter is meaningful only when the ApplyContentMarkingHeaderEnabled parameter value is either $true or $false.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyContentMarkingHeaderFontName
The ApplyContentMarkingHeaderFontName parameter specifies the font of the header text. If the value contains spaces, enclose the value in quotation marks ("). For example "Courier New"
.
This parameter is meaningful only when the ApplyContentMarkingHeaderEnabled parameter value is either $true or $false.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyContentMarkingHeaderFontSize
The ApplyContentMarkingHeaderFontSize parameter specifies the font size (in points) of the header text.
This parameter is meaningful only when the ApplyContentMarkingHeaderEnabled parameter value is either $true or $false.
Type: | System.Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyContentMarkingHeaderMargin
The ApplyContentMarkingHeaderMargin parameter specifies the size (in points) of the header margin.
This parameter is meaningful only when the ApplyContentMarkingHeaderEnabled parameter value is either $true or $false.
Note: In Microsoft Word, the specified value is used as a top margin and left margin or right margin for left-aligned or right-aligned content marks. A minimum value of 15 points is required. Word also adds a constant offset of 5 points to the left margin for left-aligned content marks, or to the right margin for right-aligned content marks.
Type: | System.Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyContentMarkingHeaderText
The ApplyContentMarkingHeaderText parameter specifies the header text. If the value contains spaces, enclose the value in quotation marks (").
This parameter is meaningful only when the ApplyContentMarkingHeaderEnabled parameter value is either $true or $false.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyDynamicWatermarkingEnabled
Note: This parameter is currently in Public Preview, isn't available in all organizations, and is subject to change.
The ApplyDynamicWatermarkingEnabled parameter enables dynamic watermarking for a specific label that applies encryption. Valid values are:
- $true: Enables dynamic watermarking for a specific label.
- $false: Disables dynamic watermarking for a specific label.
You set the watermark text with the DynamicWatermarkDisplay parameter. For more information about using dynamic watermarks for supported apps, see Dynamic watermarks.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyWaterMarkingEnabled
The ApplyWaterMarkingEnabled parameter enables or disables the Apply Watermarking Header action for the label. Valid values are:
- $true: The Apply Watermarking Header action is enabled.
- $false: The Apply Watermarking Header action is disabled.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyWaterMarkingFontColor
The ApplyWaterMarkingFontColor parameter specifies the color of the watermark text. This parameter accepts a hexadecimal color code value in the format #xxxxxx
. The default value is #000000
.
This parameter is meaningful only when the ApplyWaterMarkingEnabled parameter value is either $true or $false.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyWaterMarkingFontName
The ApplyWaterMarkingFontName parameter specifies the font of the watermark text. If the value contains spaces, enclose the value in quotation marks ("). For example "Courier New"
.
This parameter is meaningful only when the ApplyWaterMarkingEnabled parameter value is either $true or $false.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyWaterMarkingFontSize
The ApplyWaterMarkingFontSize parameter specifies the font size (in points) of the watermark text.
This parameter is meaningful only when the ApplyWaterMarkingEnabled parameter value is either $true or $false.
Type: | System.Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ApplyWaterMarkingLayout
The ApplyWaterMarkingLayout parameter specifies the watermark alignment. Valid values are:
- Horizontal
- Diagonal
This parameter is meaningful only when the ApplyWaterMarkingEnabled parameter value is either $true or $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
The ApplyWaterMarkingText parameter specifies the watermark text. If the value contains spaces, enclose the value in quotation marks (").
This parameter is meaningful only when the ApplyWaterMarkingEnabled parameter value is either $true or $false.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ColumnAssetCondition
This parameter is reserved for internal Microsoft use.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Comment
The Comment parameter specifies an optional comment. If you specify a value that contains spaces, enclose the value in quotation marks ("), for example: "This is an admin note".
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Conditions
The Conditions parameter is used for automatic labeling of files and email for data in use.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Confirm
The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on if the cmdlet requires confirmation before proceeding.
- Destructive cmdlets (for example, Remove-* cmdlets) have a built-in pause that forces you to acknowledge the command before proceeding. For these cmdlets, you can skip the confirmation prompt by using this exact syntax:
-Confirm:$false
. - Most other cmdlets (for example, New-* and Set-* cmdlets) don't have a built-in pause. For these cmdlets, specifying the Confirm switch without a value introduces a pause that forces you acknowledge the command before proceeding.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ContentType
The ContentType parameter specifies where the sensitivity label can be applied. Valid values are:
- File
- Site
- UnifiedGroup
- PurviewAssets
- Teamwork
- SchematizedData
Values can be combined, for example: "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
The DefaultContentLabel specifies a label that can be automatically applied to meetings created in a labeled Teams channel.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-DisplayName
The DisplayName parameter specifies the display name for the sensitivity label. The display name appears in any client that supports sensitivity labels. This includes Word, Excel, PowerPoint, Outlook, SharePoint, Teams, and Power BI.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-DynamicWatermarkDisplay
Note: This parameter is currently in Public Preview, isn't available in all organizations, and is subject to change.
The DynamicWatermarkDisplay parameter specifies the watermark text to display for a given label. This parameter supports text and the following special tokens:
- "`${Consumer.PrincipalName}": Required. The value is the user principal name (UPN) of the user.
- "`${Device.DateTime}": Optional. The value is current date/time of the device used to view the document.
Tip The back quotation mark character ( ` ) is required as an escape character for the dollar sign character ( $ ) in PowerShell. For more information, see Escape characters in Exchange PowerShell.
This parameter is meaningful only when the ApplyDynamicWatermarkingEnabled parameter value is $true.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-EncryptionContentExpiredOnDateInDaysOrNever
The EncryptionContentExpiredOnDateInDaysOrNever parameter specifies when the encrypted content expires. Valid values are:
- An integer (number of days)
- The value
Never
This parameter is meaningful only when the EncryptionEnabled parameter value is either $true or $false.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-EncryptionDoNotForward
The EncryptionDoNotForward parameter specifies whether the Do Not Forward template is applied. Valid values are:
- $true: The Do Not Forward template is applied.
- $false: The Do Not Forward template is not applied.
This parameter is meaningful only when the EncryptionEnabled parameter value is either $true or $false.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-EncryptionDoubleKeyEncryptionUrl
This parameter is reserved for internal Microsoft use.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-EncryptionEnabled
The EncryptionEnabled parameter specifies whether encryption in enabled. Valid values are:
- $true: Encryption is enabled.
- $false: Encryption is disabled.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-EncryptionEncryptOnly
The EncryptionEncryptOnly parameter specifies whether the encrypt-only template is applied. Valid values are:
- $true: The encrypt-only template is applied.
- $false: The encrypt-only template is not applied.
This parameter is meaningful only when the EncryptionEnabled parameter value is either $true or $false.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-EncryptionOfflineAccessDays
The EncryptionOfflineAccessDays parameter specifies the number of days that offline access is allowed.
This parameter is meaningful only when the EncryptionEnabled parameter value is either $true or $false.
Type: | System.Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-EncryptionPromptUser
The EncryptionPromptUser parameter specifies whether to set the label with user defined permission in Word, Excel, and PowerPoint. Valid values are:
- $true: The label is set with user defined permissions in Word, Excel and PowerPoint.
- $false: The label is not set with user defined permissions in Word, Excel and PowerPoint.
This parameter is meaningful only when the EncryptionEnabled parameter value is either $true or $false, and when the EncryptionProtectionType parameter value is UserDefined.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-EncryptionProtectionType
The EncryptionProtectionType parameter specifies the protection type for encryption. Valid values are:
- Template
- RemoveProtection
- UserDefined
This parameter is meaningful only when the EncryptionEnabled parameter value is either $true or $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
The EncryptionRightsDefinitions parameter specifies the rights users have when accessing protected. This parameter uses the syntax Identity1:Rights1,Rights2;Identity2:Rights3,Rights4
. For example, john@contoso.com:VIEW,EDIT;microsoft.com:VIEW
.
This parameter is meaningful only when the EncryptionEnabled parameter value is either $true or $false and the EncryptionProtectionType parameter value is Template.
Type: | EncryptionRightsDefinitionsParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-EncryptionRightsUrl
The EncryptionRightsUrl parameter specifies the URL for hold your own key (HYOK) protection.
This parameter is meaningful only when the EncryptionEnabled parameter value is either $true or $false.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Identity
The Identity parameter specifies the sensitivity label that you want to modify. You can use any value that uniquely identifies the label. For example:
- Name
- Distinguished name (DN)
- GUID
Type: | ComplianceRuleIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-LabelActions
This parameter is reserved for internal Microsoft use.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-LocaleSettings
The LocaleSettings parameter specifies one or more localized label names and label Tooltips in different languages. Regions include all region codes supported in Office Client applications. Valid values use the following syntax (JSON):
- Label display names:
{"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"}]}
- Label Tooltips:
{"localeKey":"Tooltip","Settings":[{"Key":"en-us","Value":"English Tooltip"},{"Key":"de-de","Value":"Deutscher Tooltip"},{"Key":"es-es","Value":"Tooltip Español"}]}
To remove a language, you need to enter an empty value for that language.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-MigrationId
This parameter is reserved for internal Microsoft use.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-NextLabel
This parameter is reserved for internal Microsoft use.
Type: | ComplianceRuleIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ParentId
The ParentId parameter specifies the parent label that you want this label to be under (a sublabel). You can use any value that uniquely identifies the parent sensitivity label. For example:
- Name
- Distinguished name (DN)
- GUID
Type: | ComplianceRuleIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-PreviousLabel
This parameter is reserved for internal Microsoft use.
Type: | ComplianceRuleIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Priority
The Priority parameter specifies a priority value for the sensitivity label that determines the order of label processing. A higher integer value indicates a higher priority.
Type: | System.Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SchematizedDataCondition
This parameter is reserved for internal Microsoft use.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Setting
This parameter is reserved for internal Microsoft use.
Type: | PswsHashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Settings
This parameter is reserved for internal Microsoft use.
Type: | PswsHashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SiteAndGroupProtectionAllowAccessToGuestUsers
The SiteAndGroupProtectionAllowAccessToGuestUsers parameter enables or disables access to guest users. Valid values are:
- $true: Guest access is enabled.
- $false: Guest access is disabled.
This parameter is meaningful only when the SiteAndGroupProtectionEnabled parameter value is $true or $false.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SiteAndGroupProtectionAllowEmailFromGuestUsers
The SiteAndGroupProtectionAllowEmailFromGuestUsers parameter enables or disables email from guest users. Valid values are:
- $true: Email from guest users is enabled.
- $false: Email from guest users is disabled.
This parameter is meaningful only when the SiteAndGroupProtectionEnabled parameter value is $true or $false.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SiteAndGroupProtectionAllowFullAccess
The SiteAndGroupProtectionAllowFullAccess parameter enables or disables full access. Valid values are:
- $true: Full access is enabled.
- $false: Full access is disabled.
This parameter is meaningful only when the SiteAndGroupProtectionEnabled parameter value is $true or $false.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SiteAndGroupProtectionAllowLimitedAccess
The SiteAndGroupProtectionAllowLimitedAccess parameter enables or disables limited access. Valid values are:
- $true: Limited access is enabled.
- $false: Limited access is disabled.
This parameter is meaningful only when the SiteAndGroupProtectionEnabled parameter value is $true or $false.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SiteAndGroupProtectionBlockAccess
The SiteAndGroupProtectionBlockAccess parameter blocks access. Valid values are:
- $true: Access is blocked.
- $false: Access is allowed.
This parameter is meaningful only when the SiteAndGroupProtectionEnabled parameter value is $true or $false.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SiteAndGroupProtectionEnabled
The SiteAndGroupProtectionEnabled parameter enables or disables the Site and Group Protection action for the label. Valid values are:
- $true: The Site and Group Protection action is enabled.
- $false: The Site and Group Protection action is disabled.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SiteAndGroupProtectionLevel
This parameter is reserved for internal Microsoft use.
Type: | SiteAndGroupProtectionLevelParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SiteAndGroupProtectionPrivacy
The SiteAndGroupProtectionPrivacy parameter specifies the privacy level for the labe. Valid values are:
- Public
- Private
This parameter is meaningful only when the SiteAndGroupProtectionEnabled parameter value is $true or $false.
Type: | Microsoft.Office.CompliancePolicy.PolicyConfiguration.AccessType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SiteExternalSharingControlType
The SiteExternalSharingControlType parameter specifies the external user sharing setting for the label. Valid values are:
- ExternalUserAndGuestSharing
- ExternalUserSharingOnly
- ExistingExternalUserSharingOnly
- Disabled
These correspond to the following settings through the admin center:
- Anyone
- New and Existing Guests
- Existing Guests
- Only people in your organization
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
The TeamsAllowedPresenters parameter controls who can present in Teams meetings. Valid values are:
- Everyone
- Organization
- Organizer
- RoleIsPresenter
- $null (blank): Users configure this setting themselves in the Teams app.
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
The TeamsAllowMeetingChat parameter controls whether chat is available in Teams meetings. Valid values are:
- Enabled
- Disabled
- Limited: Chat is available only for the duration of the call.
- $null (blank): Users configure this setting themselves in the Teams app.
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
The TeamsBypassLobbyForDialInUsers parameter controls the lobby experience for dial-in users who join Teams meetings. Valid values are:
- $true: Dial in users bypass the lobby when joining Teams meetings.
- $false: Dial in users don't bypass the lobby when joining Teams meetings.
- $null (blank): Users configure this setting themselves in the Teams app.
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
The TeamsCopyRestrictionEnforced parameter controls whether chat messages in Teams meetings can be copied to the clipboard. Valid values are:
- $true: Chat messages can be copied to the clipboard.
- $false: Chat messages can't be copied to the clipboard.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-TeamsEndToEndEncryptionEnabled
The TeamsEndToEndEncryptionEnabled parameter controls video stream encryption in Teams meetings. Valid values are:
- $true: Video stream encryption is enabled.
- $false: Video stream encryption is not enabled.
- $null (blank): Users configure this setting themselves in the Teams app.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-TeamsLobbyBypassScope
The TeamsLobbyBypassScope parameter controls who bypasses the lobby when joining Teams meetings. Valid values are:
- Everyone
- Invited
- Organization
- OrganizationAndFederated
- OrganizationExcludingGuests
- Organizer
- $null (blank): Users configure this setting themselves in the Teams app.
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
The TeamsLobbyRestrictionEnforced parameter controls whether participants bypass the lobby when joining Teams meetings. Valid values are:
- $true: Users bypass the lobby when joining Teams meetings.
- $false: Users don't bypass the lobby when joining Teams meetings.
- $null (blank): Users configure this setting themselves in the Teams app.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-TeamsPresentersRestrictionEnforced
The TeamsPresentersRestrictionEnforced parameter controls whether presenter restrictions are enabled in Teams meetings. Valid values are:
- $true: Presenter restrictions are enabled in Teams meetings.
- $false: Presenter restrictions aren't enabled in Teams meetings.
- $null (blank): Users configure this setting themselves in the Teams app.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-TeamsProtectionEnabled
The TeamsProtectionEnabled parameter controls whether Teams protection is enabled in Teams meetings. Valid values are:
- $true: Teams protection is enabled in Teams meetings.
- $false: Teams protection is not enabled in Teams meetings.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-TeamsRecordAutomatically
The TeamsRecordAutomatically parameter controls whether Teams meetings are automatically recorded after they start. Valid values are:
- $true: Teams meetings are automatically recorded after they start.
- $false: Teams meetings are not automatically recorded.
- $null (blank): Users configure this setting themselves in the Teams app.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-TeamsVideoWatermark
The TeamsVideoWatermark parameter controls whether a watermark is shown in Teams meetings. Valid values are:
- None
- EnabledForContentSharing
- EnabledForVideo
- $null (blank): Users configure this setting themselves in the Teams app.
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
The TeamsWhoCanRecord parameter controls who can record Teams meetings. Valid values are:
- Organizer
- Coorganizers
- Presenters
- $null (blank): Users configure this setting themselves in the Teams app.
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
The ToolTip parameter specifies the default tooltip and sensitivity label description that's seen by users. It the value contains spaces, enclose the value in quotation marks (").
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-WhatIf
The WhatIf switch doesn't work in Security & Compliance PowerShell.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |