A PowerShell-based toolkit that helps organizations deploy a reusable Microsoft Purview security and compliance baseline.
The toolkit automates tenant settings, sensitivity labels, label publishing, Data Loss Prevention policies, optional retention, AI governance controls, and HTML deployment reporting.
Important
This baseline is a starting point, not a ready-made configuration for every tenant. Review licensing, permissions, settings, assignments, and customer requirements. Always start with -WhatIf, test in a pilot tenant, and review the proposed changes before deployment.
- Prepare before you configure: Read the Purview Readiness & Preparation Guide to identify prerequisites, define data classification and responsibilities, and plan the required tenant, endpoint, and network configuration.
- Review Purview Policies: Purpose, Configuration & Impact to understand what each policy does, where it applies, and how it is configured.
- Review Deployment coverage and complete Before deployment.
- Review the licensing considerations below and confirm the requirements for the selected workloads.
- Review Baseline configuration and adapt PurviewConfig.psd1 to the customer requirements.
- Follow How to run, including the video tutorial, and start with
-WhatIf. - Review the deployment output and HTML report, validate the resulting tenant configuration, and assess DLP simulation results before enabling enforcement.
| Section | What you will find |
|---|---|
| Getting started | Preparation, configuration review, and deployment guidance. |
| Licensing considerations | Licensing checks before selecting workloads. |
| Toolkit components | Main script, configuration, modules, and additional scripts. |
| Deployment coverage | Included workloads and protection scenarios. |
| Notable capabilities | Key baseline capabilities and deployment safeguards. |
| Documentation | Detailed guides, security information, and repository license. |
Choose one standalone package.
| License | Supported | Policy types |
|---|---|---|
| Microsoft 365 E7 | ✅ Full support | All policy types |
| Microsoft 365 E5 | ✅ Full support | All policy types |
| Microsoft 365 E3 + Purview Suite | ✅ Full support | All policy types |
| Business Premium + Purview Suite | ✅ Full support | All policy types |
Designed for organizations using Microsoft 365 Business Premium and other licenses with partial feature compatibility.
| License | Supported Features |
|---|---|
| Microsoft 365 Business Premium | |
| Microsoft 365 E3 | |
| Microsoft 365 F3 | |
| Microsoft 365 F1 + Purview Suite FLW | |
| Microsoft 365 F3 + Purview Suite FLW | |
| Microsoft 365 F1 |
Important: Defender Suite add-on are needed for full e-DLP experience for Microsoft 365 F1 and F3 users with Purview Suite.
Important: Microsoft 365 F1 doesn't support Sensitivite information types (SIT's), auto retention and labelling and DLP. Only manual sensitivity labels.
Disclaimer: Licensing and feature availability can change. Verify current Microsoft licensing documentation before purchasing or deploying.
Enterprise licenses: Microsoft Enterprise Plan Comparison
SMB licenses: Microsoft SMB Plan Comparison
This repository contains one configurable deployment toolkit, rather than separate license-specific export packages.
| Component | Location | Purpose |
|---|---|---|
| Main deployment script | Deploy-PurviewBestPractice.ps1 | Entry point for the deployment workflow. |
| Baseline configuration | PurviewConfig.psd1 | Central configuration to review and adapt before deployment. |
| Deployment modules | Modules | Connection, workload configuration, logging, and reporting components. |
| Additional scripts | AdHoc | Scripts for specific tasks outside the main deployment entry point. |
| Public documentation | docs/public | Preparation, configuration, and deployment guides. |
Warning
Keep the deployment folder structure unchanged. Do not move configuration files or deployment modules into the documentation folder.
| Area | Included configuration |
|---|---|
| 🛡️ Tenant settings | Configured audit, labeling, and SharePoint integration settings, with optional co-authoring and Premium Audit settings. |
| 🏷️ Sensitivity labels | Public, General, Confidential, and Highly Confidential label hierarchy, including the configured sublabels and protection settings. |
| 📢 Label publishing | Label publication, mandatory labeling, downgrade justification, and default labeling behavior. |
| 🚫 Label-based DLP | Policies for labeled content across Exchange, SharePoint, OneDrive, and supported endpoints. |
| 🔎 SIT-based DLP | Exchange policies for selected financial, identity, social security, passport, and tax information types. |
| 🗃️ Retention | Optional Exchange retention configuration, requiring explicit deployment selection. |
| 🤖 AI governance | A Microsoft 365 Copilot DLP control targeting Highly Confidential content. |
| 📄 Reporting | Deployment stage summary and HTML deployment report. |
For policy names, detection settings, label descriptions, and retention behavior, see Baseline configuration.
- Reusable configuration: Review and adapt a central configuration file for the destination tenant.
- Structured information protection: Deploy a documented sensitivity label hierarchy and publishing configuration.
- Complementary DLP controls: Configure policies based on sensitivity labels and selected sensitive information types.
- Review before enforcement: Start with
-WhatIfand review DLP simulation results before enabling blocking. - Optional retention: Retention is not deployed by default and requires
-ApplyRetention. - Deployment visibility: Review console output, stage status, and the generated HTML report.
Warning
Policy names describe intent, but configuration and enforcement state determine behavior. DLP simulation does not mean active blocking. Review the actual policies and validate their behavior in the destination tenant.
Warning
The documented optional Exchange retention policy retains content for 2,555 days from creation and then deletes it. Do not enable it without confirming the customer's legal, regulatory, and business requirements.
| Resource | Description |
|---|---|
| ✅ Before deployment | Review preparation checks, configuration, permissions, and pilot requirements. |
| 🚀 How to run | Watch the video tutorial and follow WhatIf validation, deployment, reporting, and verification steps. |
| 🛡️ Deployment coverage | Review the workloads and controls included in the toolkit. |
| ⚙️ Baseline configuration | Understand tenant settings, labels, publishing, DLP, retention, and AI governance. |
| 📂 Repository structure | Find the deployment files and understand the role of each folder. |
| 🐛 Reporting issues | Report problems without disclosing tenant information. |
| 🔐 Security guidance | Review security precautions and reporting information. |
| 📜 License | Read the repository license. |
This toolkit provides a reusable starting point. It does not replace a customer-specific security assessment, licensing review, or deployment approval.
Review all selected settings before use. Test in a pilot tenant, maintain an appropriate recovery plan, and validate the resulting configuration after deployment.
Deploying this baseline does not by itself establish regulatory compliance.