Microsoft Intune

Assignment filter properties and operators reference

26 August 2026Retirement+3 / −9 lines

In brief

The osVersion property is now documented as deprecated. New assignment filters can’t use it, while existing filters continue to work; operatingSystemVersion is the replacement.

What Intune admins need to know

Use operatingSystemVersion when creating new assignment filters. No immediate migration is required for existing osVersion filters.

This summary was assembled from the tracked documentation change. Verify important details in the full Microsoft Learn article.

Documentation change

View full page diff

View on Microsoft Learn

The comparison below shows only the changed extract. Use the full-page view for complete context.

macOS
Windows

Note
The operatingSystemVersion property is in public preview. For more information on what that means, go to Public preview in Microsoft Intune.
osVersion (OS Version): Create a filter rule based on the Intune device operating system (OS) version. Enter the full string value (using -eq, -ne, -in, -notIn operators), or partial value (using -startswith, -contains, -notcontains operators).

Tip
The osVersion property is deprecated. Use the operatingSystemVersion property instead. You can't create new assignment filters that use osVersion. Existing assignment filters that use osVersion continue to work.

Examples:

iOS/iPadOS

Windows

osVersion (OS Version): Create a filter rule based on the client reported operating system (OS) version. Enter the full string value (using -eq, -ne, -in, -notIn operators), or partial value (using -startswith, -contains, -notcontains operators).

Tip
The osVersion property is deprecated. Use the operatingSystemVersion property instead. You can't create new assignment filters that use osVersion. Existing assignment filters that use osVersion continue to work.

Examples:
.

osVersion ~~(OS Version)~~~~: Create a filter rule based on the client reported operating system (OS) version. Enter the full string value (using~~ -eq, -ne, -in, -notIn ~~operators), or partial value (using~~ -startswith, -contains, -notcontains ~~operators).~~

Tip
The osVersion property is being deprecated. Instead, use the operatingSystemVersion property. When operatingSystemVersion is generally available (GA), the osVersion property will retire, and you won't be able to create new assignment filters using this property. Existing assignment filters that use osVersion continue to work.

Examples: