Skip to content

About

A PowerShell-based toolkit for deploying a reusable Microsoft Purview security and compliance baseline, including tenant settings, sensitivity labels, DLP policies, optional retention, AI governance controls, and HTML deployment

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

85 Commits

Folders and files

Repository files navigation

🛡️ ALSO Microsoft Security Purview

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.

🚀 Getting started

  1. 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.
  2. Review Purview Policies: Purpose, Configuration & Impact to understand what each policy does, where it applies, and how it is configured.
  3. Review Deployment coverage and complete Before deployment.
  4. Review the licensing considerations below and confirm the requirements for the selected workloads.
  5. Review Baseline configuration and adapt PurviewConfig.psd1 to the customer requirements.
  6. Follow How to run, including the video tutorial, and start with -WhatIf.
  7. Review the deployment output and HTML report, validate the resulting tenant configuration, and assess DLP simulation results before enabling enforcement.

Quick navigation

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.

🔑 Licensing considerations

Purview licensing guide

Choose one standalone package.

✅ (Full Experience) E5 tag

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

⚠️ (Limited Experience) BP tag

Designed for organizations using Microsoft 365 Business Premium and other licenses with partial feature compatibility.

License Supported Features
Microsoft 365 Business Premium ⚠️ Supported with limitations (without full DLP, retention and labelling experience)
Microsoft 365 E3 ⚠️ Supported with limitations (without full DLP, retention and labelling experience)
Microsoft 365 F3 ⚠️ Supported with limitations (without full DLP, retention and labelling experience)
Microsoft 365 F1 + Purview Suite FLW ⚠️ Supported with limitations (except e-DLP policies)
Microsoft 365 F3 + Purview Suite FLW ⚠️ Supported with limitations (except e-DLP policies)
Microsoft 365 F1 ⚠️ Only manual sensitivity labels.

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


📦 Toolkit components

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.

🌐 Deployment coverage

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.

✨ Notable capabilities

  • 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 -WhatIf and 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.


📚 Documentation

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.

⚠️ Disclaimer

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.

About

A PowerShell-based toolkit for deploying a reusable Microsoft Purview security and compliance baseline, including tenant settings, sensitivity labels, DLP policies, optional retention, AI governance controls, and HTML deployment

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages