microsoft /zerotrustassessment
Repository for the Zero Trust Assessment project
★ 497⑂ 207👁 15⑃ 1,293● 334▤ 10
More from this author
497
stars
207
forks
15
watchers
1,293
prs
334
issues
10
releases
README
Zero Trust Assessment The Zero Trust Assessment is a PowerShell module for administrators who want to review their Microsoft 365 tenant and Azure security configuration. It runs read-only assessments, generates local reports, and provides recommendations to help prioritize improvements. [!IMPORTANT] This is a community project maintained by Microsoft employees, not an official Microsoft product. It is provided as-is and is not supported through any Microsoft support program or service. See SUPPORT.md for community help and issue-reporting guidance. What the assessment covers All seven current pillars run by default: Identity, Devices, Network, Data, Infrastructure, SecOps, and AI. The -Preview switch is reserved for preview-only features and is not required for these pillars. Coverage depends on service connections, permissions, licenses, and available data. Review skipped checks and errors as well as pass/fail results. The assessment does not apply remediation. The repository can contain changes not yet available in a published package. See the release history for shipped changes, and the PowerShell guide for the current source's requirements and behavior. Installing and running the assessment Before you start, review the prerequisites and required permissions and roles. Use PowerShell 7.6 or later for the current source's dependencies; published packages can have different requirements. Windows is needed for full service coverage. A dedicated Windows VM and a fresh PowerShell session help avoid dependency conflicts. Install the stable package, connect to your tenant, and run the assessment: powershell Install-PSResource -Name ZeroTrustAssessment -Scope CurrentUser Connect-ZtAssessment -Tenant contoso.onmicrosoft.com Invoke-ZtAssessment Replace contoso.onmicrosoft.com with your tenant's verified domain or GUID. The default output directory is .\ZeroTrustReport; use a new output directory for each fresh run. Protect the reports and exports because they can contain sensitive tenant data. See the PowerShell guide for app-only certificate authentication, pillar selection and resume behavior, and configuration tuning. Telemetry is enabled by default, with the tenant ID as its only tenant-specific custom property. Assessment results are not included. Use -DisableTelemetry to opt out; see data handling and telemetry for payload and network-metadata details. Infrastructure Pillar Scope Infrastructure results use Microsoft Defender for Cloud recommendations and include only accessible Azure subscriptions tagged with ZeroTrustAssessment:Infrastructure. Arrange the tags and Azure read access before running; see Infrastructure scope. Quicklinks Assessment overview on Microsoft Learn. Installation and operating guide, including permissions, authentication, outputs, and troubleshooting. Log locations and support packages and advanced diagnostic analysis. Interactive synthetic-data demo. Share feedback or report a bug. Review the s
Top issues
#1603Sorting User Impact / Implementation effort begins with medium or high in report4 comments · 2026-10-20#1624Failed to query warnings3 comments · 2026-10-26#1462Which workshop tiles have Imported content2 comments · 2026-07-29#1412Test ID: 21786 and Test ID: 21941 are duplicates.2 comments · 2026-07-16#1393Reports in ZT WS Tool: Tagging & filtering2 comments · 2026-07-09#99625403 - DC Agent is deployed and enforcing strong authentication policies - Fails in cloud-only tenant2 comments · 2026-03-04#1478Unclear test/false negative: Communication compliance monitoring is configured for enterprise AI tools (Test ID: 35040)1 comments · 2026-08-03#1472Request: open Tier-1 AI-readiness baseline PR (ruleset blocks read-only PR creation)1 comments · 2026-07-31
Latest release
3.1.0 3.1.0 2026-10-20Release roll-up expanding Security Operations and Network coverage, adding new report insights, and improving data collection for larger tenants. Install from PowerShell Gallery: powershell Install-PSResource -Name ZeroTrustAssessment -Version 3.1.0 ⬆️ Upgrade requirements PowerShell 7.6 or later is required. 📊 Report experience Added a Microsoft 365 protection circuit that shows Global Secure Access traffic acquisition and compliant-network enforcement as separate stages. Added a Private Access posture funnel showing app segmentation, strong authentication, and Appl