Skip to content

Commit 1e61cfb

Browse files
committed
update auto apply label unit
1 parent cb2dda3 commit 1e61cfb

File tree

2 files changed

+70
-42
lines changed

2 files changed

+70
-42
lines changed

learn-pr/wwl-sci/purview-implement-manage-retention/auto-apply-retention-label.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,12 @@ title: Create and manage auto-apply retention labels
44
metadata:
55
title: Create and manage auto-apply retention labels
66
description: "Create and manage auto-apply retention labels."
7-
ms.date: 07/01/2024
7+
ms.date: 05/19/2025
88
author: wwlpublish
99
ms.author: riswinto
1010
ms.topic: unit
1111
azureSandbox: false
1212
labModal: false
13-
durationInMinutes: 8
13+
durationInMinutes: 7
1414
content: |
1515
[!include[](includes/auto-apply-retention-label.md)]
Lines changed: 68 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -1,70 +1,98 @@
1-
Properly managing the lifecycle of your organization's content is essential for meeting legal and regulatory requirements and minimizing risks. Automating the application of retention labels streamlines this process. It systematically organizes how content is retained or deleted according to specific rules. This process ensures crucial information is protected until it's no longer needed.
1+
Automatic retention helps your organization manage content consistently and reduce risk. By applying retention labels based on specific conditions, Microsoft Purview can help protect important information until it's no longer needed, without requiring users to classify content themselves.
22

3-
## Understand automatic retention
3+
## What is automatic retention?
44

5-
Automatic retention applies predefined labels to content without manual intervention. This system identifies and labels content based on defined criteria such as sensitivity, keywords, or data type, enabling:
5+
Automatic retention uses conditions like sensitive information types, keywords, or trainable classifiers to identify content and apply the appropriate retention label. This reduces the need for user training and improves the consistency of retention across Microsoft 365 services. Once a label is applied automatically, it can't be removed or replaced by another auto-apply policy.
66

7-
- **Simplified user experience**: Reduces the need for extensive training as the system handles content classification.
8-
- **Enhanced consistency**: Ensures content is uniformly managed according to defined policies.
9-
- **Increased productivity**: Allows users to focus on their primary responsibilities without compliance distractions.
7+
Benefits include:
108

11-
## Understand simulation mode
9+
- **Consistent labeling**: Content is classified according to organization-wide rules.
10+
- **Improved productivity**: Users don't have to decide how to label or manage files.
11+
- **Fewer mistakes**: Automated rules reduce the chance of mislabeling or skipping important items.
1212

13-
Simulation mode offers an environment to test and refine retention policies using conditions similar to the WhatIf parameter in PowerShell. This feature allows administrators to:
13+
## What is simulation mode?
1414

15-
- **Preview policies before implementation**: Simulate the effects of a policy on your content before full deployment.
16-
- **Refine and adjust**: Modify the policy based on simulation outcomes to better meet organizational needs.
17-
- **Scale cautiously**: Gradually expand the scope of the policy, making adjustments based on iterative simulations.
15+
Simulation mode lets you test your auto-labeling policy before turning it on. It's similar to using the WhatIf parameter in PowerShell. You can see which items would have been labeled without making changes to live content.
16+
17+
Simulation mode helps you:
18+
19+
- Validate that your conditions are accurate
20+
- Adjust your policy before it's active
21+
- Scale the policy gradually by starting with smaller scopes
22+
23+
Simulation results are visible for up to seven days. Policies using trainable classifiers can't use simulation mode.
1824

1925
## Before you begin
2026

21-
Before implementing auto-apply retention label policies, ensure:
27+
Before setting up automatic retention labels, make sure:
28+
29+
- **Permissions**: You have the right permissions, such as being in the **Compliance Administrator** role group. You can also use **Retention Management** or **View-Only Retention Management** roles.
30+
- **Auditing is enabled**: Simulation mode requires audit logs to be turned on.
31+
- **Labels exist**: Create the retention labels you plan to use before setting up the policy.
32+
33+
## How to create an auto-apply retention label policy
34+
35+
1. Sign in to the [Microsoft Purview portal](https://purview.microsoft.com/?azure-portal=true).
36+
37+
1. Go to either **Records Management** or **Data Lifecycle Management** and select **Auto-apply a label**:
2238

23-
- **Permissions**: Ensure you have the necessary permissions within the **Compliance Administrator** role group to create and manage retention labels. Alternative roles include **Retention Management** for active management and **View-Only Retention Management** for read-only access.
24-
- **Enable Auditing**: Auditing must be active to use simulation mode effectively.
25-
- **Retention labels**: Confirm that necessary retention labels are created and available for use.
39+
- **Solutions** > **Records management** > **Policies** > **Label policies** > **Auto-apply a label**
40+
- **Solutions** > **Data Lifecycle Management** > **Policies** > **Label policies** > **Auto-apply a label**
2641

27-
## Implement automatic retention labels
42+
1. Name your policy and provide a description.
2843

29-
To apply automatic retention labels:
44+
1. Choose the condition type to trigger the label. You can use:
3045

31-
1. Navigate to **Auto-apply a label** in either the Microsoft Purview portal or Microsoft Purview compliance portal.
46+
- Sensitive information types (SITs)
47+
- Keywords or metadata (KQL)
48+
- Trainable classifiers
49+
- Cloud attachments and links shared in Exchange, Teams, Viva Engage, and Copilot
3250

33-
- **Microsoft Purview portal**: [Sign in to the Microsoft Purview portal](https://purview.microsoft.com/?azure-portal=true)
51+
1. For the **Assign admin units page**, keep the default of **Full directory**. Currently, admin units aren't supported for this policy.
3452

35-
- If you're using records management: **Records management** > **Label policies** > **Auto-apply a label**.
36-
- If you're using data lifecycle management: **Data Lifecycle Management** > **Policies** > **Label policies** > **Auto-apply a label**.
53+
1. Choose the policy type:
3754

38-
- **Microsoft Purview compliance portal**: [Sign in to the Microsoft Purview compliance portal](https://compliance.microsoft.com/?azure-portal=true)
55+
- **Adaptive scope**: Uses attributes like job title or department (requires preconfigured scopes)
56+
- **Static scope**: Manually select services or locations
3957

40-
- If you're using records management: **Solutions** > **Label policies** > **Auto-apply a label**.
41-
- If you're using data lifecycle management: **Solutions** > **Data lifecycle management** > **Policies** > **Retention labels** > **Auto-apply a label**.
58+
1. Select the retention label to apply.
4259

43-
1. Enter a name and description for your new auto-labeling policy.
44-
1. **Choose the type of content to apply the label to** by selecting one of the available conditions that describe your content.
45-
1. If your organization uses administrative units and you want to restrict the policy to specific users, select the appropriate units. If not, select **Full directory** to include all locations.
46-
1. On the **Choose the type of retention policy to create** page, select either **Adaptive** or **Static**. If you want to use adaptive scopes, you need to have one created before selecting this option.
47-
1. Depending on if you selected adaptive or static scope:
48-
- **For adaptive**: On the **Choose adaptive policy scopes and locations page**, add scopes, and select locations. If you don't have any adaptive scopes created, no options appear on this page.
49-
- **For static**: On the **Choose locations page**, adjust location settings as needed.
50-
1. Confirm the retention label to apply, decide if you want to run the policy in simulation mode or turn it on immediately. Review your settings before submitting.
60+
1. Choose whether to run the policy in simulation mode or turn it on immediately.
5161

52-
After content is labeled using an auto-apply label policy, the applied label can't be automatically removed or changed. This restriction applies whether altering the content or the policy, or implementing a new auto-apply label policy.
62+
1. Review your settings and submit the policy.
5363

54-
## Configure conditions for auto-apply retention labels
64+
## Conditions for automatic labeling
5565

56-
Tailor your retention strategies by setting conditions based on:
66+
You can tailor your policy by combining different conditions:
5767

5868
### Sensitive information types
5969

60-
Enable retention labels to automatically apply when content meets predefined sensitive information types like financial data or personal identifiers. You can customize these settings by adjusting confidence levels and instance counts, which helps balance the precision of detections and minimize false positives effectively.
70+
Use this option to apply retention labels when content includes built-in or custom sensitive information types. You can fine-tune how content is matched by adjusting:
6171

62-
### Keywords or searchable properties
72+
- **Confidence levels**: Such as high, medium, or low
73+
- **Instance counts**: How many times the data type must appear in the content
6374

64-
Use Keyword Query Language (KQL) to identify content that includes specific words, phrases, or metadata properties. For instance, create policies to automatically label documents containing terms like `"contract agreement"` or `"confidential"`. Enhance the specificity of these searches by using logical operators like AND, OR, and NOT, allowing for more accurate categorization of content.
75+
This method is useful for labeling content that contains things like financial data, government-issued IDs, or health-related information.
76+
77+
### Keywords and searchable properties
78+
79+
Use Keyword Query Language (KQL) to label content that contains specific phrases or metadata. For example:
80+
81+
- "Confidential project"
82+
- Metadata tags like department: HR
83+
84+
You can use logical operators like AND, OR, and NOT to combine conditions.
6585

6686
### Trainable classifiers
6787

68-
For more dynamic and adaptable content management, you can use trainable classifiers to enhance your auto-apply retention label configurations. These classifiers learn to recognize different types of documents, from business communications to legal agreements, by analyzing examples. Once trained, they can automatically label new, similar content, facilitating consistent and automated compliance management.
88+
Trainable classifiers recognize content based on patterns learned from sample documents. Once trained, the classifier can be added to an auto-labeling policy.
89+
90+
This method is useful for identifying:
91+
92+
- Contracts
93+
- Business communications
94+
- Financial statements
95+
96+
Simulation mode can't be used with this method.
6997

70-
These conditions can be combined to develop a comprehensive and layered retention policy, ensuring thorough coverage across various data types and content categories. For example, a policy might use both sensitive information types for detecting any financial data and trainable classifiers to catch complex patterns like specific forms or reports not covered by simpler keyword or metadata matches.
98+
By combining conditions, you can build detailed policies that label a broad set of items across your environment. For example, you might use sensitive information types to detect credit card data and a classifier to identify financial statements. This layered approach helps you meet your compliance requirements without relying on users to apply labels manually.

0 commit comments

Comments
 (0)