Skip to content

v4.1.0 - Assignment Filters

Choose a tag to compare

View all tags
@ugurkocde ugurkocde released this 27 Apr 12:49
· 4 commits to main since this release
v4.1.0
2839fa0

What's new

You can now see Intune assignment filters wherever assignments are shown. Closes #122.

Filters in Intune scope an assignment to a subset of devices based on properties (OS version, model, ownership, manufacturer, etc.). Until now, the only way to know whether a filter was attached to an assignment was to open the Intune portal and click into each one. v4.1.0 surfaces this directly in every output.

Where filters appear

Every assignment now shows the filter name and include/exclude type when one is attached. Format: <target> (Filter: <name> [Include|Exclude]).

  • Console output for Get-IntuneUserAssignment, Get-IntuneGroupAssignment, Get-IntuneDeviceAssignment, Get-IntuneAllUsersAssignment, Get-IntuneAllDevicesAssignment, Get-IntuneAllPolicies
  • Simulation results from Test-IntuneGroupMembership and Test-IntuneGroupRemoval
  • Comparison output from Compare-IntuneGroupAssignment
  • Reverse search from Search-IntunePolicy
  • CSV exports get dedicated FilterName and FilterType columns
  • HTML reports from New-IntuneHTMLReport get a new Filter column on every assignment table

Coverage includes: Configuration Profiles, Settings Catalog, Compliance Policies, App Protection, App Configuration, Mobile Apps, Platform and Remediation Scripts, Autopilot Deployment Profiles, Enrollment Status Page, Endpoint Security (Antivirus, Disk Encryption, Firewall, EDR, ASR, Account Protection), and Windows 365 Cloud PC Provisioning Policies and User Settings.

Under the hood

  • Get-AssignmentFilterLookup fetches all filters once at connect time and caches them. No extra Graph calls per assignment.
  • Format-AssignmentFilter is a single helper used everywhere a filter is rendered, so the format stays consistent.
  • Equality checks against Excluded / Included / All Users / All Devices were updated to startswith comparisons so the new filter suffix does not break detection logic in simulations and comparisons.

Tests

  • 44 Pester 5 unit tests covering every helper and the CSV regex extractor, running on Ubuntu, Windows, and macOS via GitHub Actions on every PR
  • Tests/Smoke/Run-Smoke.ps1 for manual pre-release verification against a live tenant

Install

Install-Module IntuneAssignmentChecker -Scope CurrentUser
IntuneAssignmentChecker

To upgrade from v4.0.0:

Update-Module IntuneAssignmentChecker

Migration

No breaking changes. Existing scripts and runbooks continue to work unchanged. Filter info is additive: assignments without a filter render exactly as before.

Full Changelog: v4.0.0...v4.1.0

Assets 2
Loading