Delen via

App- en apparaateigenschappen, operators en regel bewerken bij het maken van filters in Microsoft Intune

  • Artikel

Wanneer u een app, nalevingsbeleid of configuratieprofiel maakt, wijst u dat app of beleid toe aan groepen (gebruikers of apparaten). Wanneer u de app of het beleid toewijst, kunt u ook toewijzingsfilters gebruiken.

U kunt filters gebruiken op beheerde apparaten (apparaten die zijn ingeschreven bij Intune) en beheerde apps (apps die worden beheerd door Intune).

Wanneer u een filter maakt, voert u de app- of apparaateigenschappen in die u in het filter wilt gebruiken. Bijvoorbeeld:

  • Voer in het filter voor uw beheerde apparaat de fabrikant van het apparaat in, zodat het beleid alleen van toepassing is op Microsoft-apparaten.
  • Voer in het filter van uw beheerde app de versie van het besturingssysteem in, zodat het beleid alleen van toepassing is op apparaten met die specifieke versie van het besturingssysteem.

Geavanceerde regelbewerking is ook beschikbaar. U kunt algemene operators, zoals and, containsen startsWith gebruiken om expressies te maken. Deze expressies worden opgeslagen en gebruikt in het filter.

In dit artikel worden de verschillende eigenschappen van beheerde apparaten, beheerde app-eigenschappen en operators beschreven die u in uw filters kunt gebruiken, en geeft voorbeelden.

Belangrijk

Microsoft Intune beëindigt de ondersteuning voor Beheer van Android-apparaten op apparaten met toegang tot Google Mobile Services (GMS) op 31 december 2024. Na die datum zijn apparaatinschrijving, technische ondersteuning, bugfixes en beveiligingspatches niet meer beschikbaar. Als u momenteel apparaatbeheerdersbeheer gebruikt, raden we u aan over te schakelen naar een andere Android-beheeroptie in Intune voordat de ondersteuning afloopt. Zie Ondersteuning voor Android-apparaatbeheerder op GMS-apparaten beëindigen voor meer informatie.

Eigenschappen van beheerde apparaten

U kunt de volgende apparaateigenschappen gebruiken in de filterregels van uw beheerde apparaat:

  • cpuArchitecture (CPU-architectuur): maak een filterregel op basis van de eigenschap CPU-architectuur van het Intune-apparaat.

    Voor Windows zijn de opties (met -eq, -ne, -in, , operators -notIn ):

    • amd64
    • x86
    • arm64
    • onbekend

    Voor macOS zijn de opties (met -eq, -ne, -in, , operators -notIn ):

    • x64
    • arm64
    • onbekend

    Voorbeelden:

    • (device.cpuArchitecture -eq "arm64")
    • (device.cpuArchitecture -in ["x64", "arm64"])
    • (device.cpuArchitecture -eq "unknown")

    Deze eigenschap is van toepassing op:

    • macOS
    • Windows 11
    • Windows 10

    Opmerking

    Momenteel bieden inschrijvingsscenario's geen ondersteuning voor de cpuArchitecture eigenschap. Ondersteuning wordt toegevoegd in een toekomstige update (geen ETA).

  • deviceCategory (Apparaatcategorie): maak een filterregel op basis van de eigenschap Intune-apparaatcategorie. Voer de volledige tekenreekswaarde in (met behulp van -eq, -ne, -in, -notIn operators) of gedeeltelijke waarde (met behulp van -startswith, -contains, -notcontains operators).

    Voorbeelden:

    • (device.deviceCategory -eq "Engineering devices")
    • (device.deviceCategory -contains "Engineering")
    • (device.model -startsWith "E")

    Deze eigenschap is van toepassing op:

    • Android apparaatbeheerder
    • Android Enterprise
    • Android (AOSP)
    • iOS/iPadOS
    • macOS
    • Windows 11
    • Windows 10

  • deviceName (Apparaatnaam): maak een filterregel op basis van de eigenschap Intune-apparaatnaam. Voer een tekenreekswaarde in voor de volledige naam van het apparaat (met behulp van , , , , -notIn operators) of gedeeltelijke waarde (met behulp van -startswith, -containsoperators-notcontains). -in-ne-eq

    Voorbeelden:

    • (device.deviceName -eq "Scott's Device")
    • (device.deviceName -in ["Scott's device", "Sara's device"])
    • (device.deviceName -startsWith "S")

    Deze eigenschap is van toepassing op:

    • Android apparaatbeheerder
    • Android Enterprise
    • Android (AOSP)
    • iOS/iPadOS
    • macOS
    • Windows 11
    • Windows 10

  • deviceOwnership (Eigendom): maak een filterregel op basis van de eigendomseigenschap van het apparaat in Intune. Selecteer Personal, Corporateof onbekende waarden met behulp van de -eq operators en -ne .

    Voorbeeld:

    • (device.deviceOwnership -eq "Personal")

    Deze eigenschap is van toepassing op:

    • Android apparaatbeheerder
    • Android Enterprise
    • Android (AOSP)
    • iOS/iPadOS
    • macOS
    • Windows 11
    • Windows 10

  • deviceTrustType (Microsoft Entra jointype): maak een filterregel op basis van het Microsoft Entra-jointype van het apparaat. Kies tussen Azure AD-gekoppelde, Azure AD-geregistreerd, Hybride Azure AD-gekoppelde of Onbekende waarden (met -eq, -ne, -in, operators -notIn ).

    Voorbeelden:

    • (device.deviceTrustType -eq "Azure AD joined")
    • (device.deviceTrustType -ne "Azure AD registered")
    • (device.deviceTrustType -in ["Hybrid Azure AD joined","Azure AD joined"])

    Deze eigenschap is van toepassing op:

    • Windows 11
    • Windows 10

    Opmerking

    De deviceTrustType eigenschap bestaat in Microsoft Entra ID en Intune. De waarden in dit artikel over Intune-filters zijn van toepassing op Intune. Ze zijn niet van toepassing op Microsoft Entra ID.

  • enrollmentProfileName (Naam van inschrijvingsprofiel): maak een filterregel op basis van de naam van het inschrijvingsprofiel. Deze eigenschap wordt toegepast op een apparaat wanneer het apparaat wordt ingeschreven. Het is een tekenreekswaarde die u hebt gemaakt en komt overeen met het Windows Autopilot-, ADE- of Google-inschrijvingsprofiel dat op het apparaat is toegepast. Als u de namen van uw inschrijvingsprofiel wilt zien, meldt u zich aan bij het Intune-beheercentrum en gaat u naar Apparaten>apparaten inschrijven.

    Voer de volledige tekenreekswaarde in (met behulp van -eq, -ne, -in, -notIn operators) of gedeeltelijke waarde (met behulp van -startswith, -contains, -notcontains operators).

    Voorbeelden:

    • (device.enrollmentProfileName -eq "DEP iPhones")
    • (device.enrollmentProfileName -startsWith "Autopilot Profile")
    • (device.enrollmentProfileName -ne $null)

    Deze eigenschap is van toepassing op:

    • Android Enterprise
    • Android (AOSP)
    • iOS/iPadOS
    • Windows 11
    • Windows 10

  • IsRooted (Geroot of gekraakt): maak een filterregel op basis van de apparaateigenschap geroot (Android) of jailbroken (iOS/iPadOS). Selecteer True, Falseof onbekende waarden met behulp van de -eq operators en -ne .

    Voorbeeld:

    • (device.isRooted -eq "True")

    Deze eigenschap is van toepassing op:

    • Android apparaatbeheerder
    • Android Enterprise (alleen werkprofiel)
    • Android (AOSP)
    • iOS/iPadOS

  • manufacturer (Fabrikant): maak een filterregel op basis van de eigenschap Intune-apparaatfabrikant. Voer de volledige tekenreekswaarde in (met behulp van -eq, -ne, -in, -notIn operators) of gedeeltelijke waarde (met behulp van -startswith, -contains, -notcontains operators).

    Voorbeelden:

    • (device.manufacturer -eq "Microsoft")
    • (device.manufacturer -startsWith "Micro")

    Deze eigenschap is van toepassing op:

    • Android apparaatbeheerder
    • Android Enterprise
    • Android (AOSP)
    • iOS/iPadOS
    • macOS
    • Windows 11
    • Windows 10

  • model (Model): maak een filterregel op basis van de eigenschap Intune-apparaatmodel. Voer de volledige tekenreekswaarde in (met behulp van -eq, -ne, -in, -notIn operators) of gedeeltelijke waarde (met behulp van -startswith, -contains, -notcontains operators).

    Gebruik voor iOS-/iPadOS- en macOS-apparaten het model, niet de productnaam. Alleen het model wordt herkend voor Apple-apparaten. Voer voor iPhone 8-apparaten bijvoorbeeld het model in als iPhone 8.

    Voorbeelden:

    • (device.model -eq "Surface Book 3")
    • (device.model -in ["Surface Book 3", "Surface Book 2"])
    • (device.model -startsWith "Surface Book")
    • (device.model -startsWith "MacBookPro")
    • (device.model -startsWith "iPhone 8")

    Deze eigenschap is van toepassing op:

    • Android apparaatbeheerder
    • Android Enterprise
    • Android (AOSP)
    • iOS/iPadOS
    • macOS
    • Windows 11
    • Windows 10

  • operatingSystemVersion (Versie van besturingssysteem): maak een filterregel op basis van de versie van het Apparaatbesturingssysteem (OS) van Intune. Voer een versiewaarde in (met behulp van -eq, -ne, -gt, -ge, -lten operators -le ).

    Voorbeelden:

    • (device.operatingSystemVersion -eq 14.2.1)
    • (device.operatingSystemVersion -gt 10.0.22000.1000)
    • (device.operatingSystemVersion -le 10.0.22631.3235)

    Ga naar operatingSystemVersion supported operators (in dit artikel) voor een lijst met ondersteunde operators.

    Deze eigenschap is van toepassing op:

    • Android apparaatbeheerder
    • Android Enterprise
    • Android (AOSP)
    • iOS/iPadOS
    • macOS
    • Windows 11
    • Windows 10

    Opmerking

    De operatingSystemVersion eigenschap is in openbare preview. Ga naar Openbare preview in Microsoft Intune voor meer informatie over wat dat betekent.

  • osVersion (versie van besturingssysteem): maak een filterregel op basis van de versie van het Intune-besturingssysteem (OS). Voer de volledige tekenreekswaarde in (met behulp van -eq, -ne, -in, -notIn operators) of gedeeltelijke waarde (met behulp van -startswith, -contains, -notcontains operators).

    Tip

    De osVersion eigenschap wordt afgeschaft. Gebruik in plaats daarvan de operatingSystemVersion eigenschap. Wanneer operatingSystemVersion de eigenschap algemeen beschikbaar (GA) is, wordt deze osVersion buiten gebruik gesteld en kun je geen nieuwe filters maken met deze eigenschap. Bestaande filters die worden gebruikt, osVersion blijven werken.

    Voorbeelden:

    • (device.osVersion -eq "14.2.1")
    • (device.osVersion -in ["10.15.3 (19D2064)","10.14.2 (18C54)"])
    • (device.osVersion -startsWith "10.0.18362")

    Deze eigenschap is van toepassing op:

    • Android apparaatbeheerder
    • Android Enterprise
    • Android (AOSP)
    • iOS/iPadOS
    • macOS
    • Windows 11
    • Windows 10

    Opmerking

    Voor Apple-apparaten bevat de OSversion eigenschap geen SPV-informatie (Security Patch Version) van Apple. De SPV is de letter na het versienummer, zoals 14.1.2a. Neem bij het maken van filters voor Apple-apparaten de SPV niet op in de regelsyntaxis OSversion .

  • operatingSystemSKU (Besturingssysteem-SKU): maak een filterregel op basis van de Windows-client os-SKU van het apparaat. Voer de volledige tekenreekswaarde in (met behulp van -eq, -ne, -in, -notIn operators) of gedeeltelijke waarde (met behulp van -startswith, -contains, -notcontains operators).

    Voorbeelden:

    • (device.operatingSystemSKU -eq "Enterprise")
    • (device.operatingSystemSKU -in ["Enterprise", "EnterpriseS", "EnterpriseN", "EnterpriseEval"])
    • (device.operatingSystemSKU -startsWith "Enterprise")

    U kunt de volgende ondersteunde waarden gebruiken voor de eigenschap Besturingssysteem-SKU . De SKU-namen worden niet weergegeven in het Intune-beheercentrum . Zorg er dus voor dat u de ondersteunde waarden in de volgende tabel gebruikt:

    Ondersteunde waarde SKU-definitie van besturingssysteem
    BusinessN Windows 10/11 Professional N (49)
    CloudEdition CloudEdition (Windows 11 SE (203)
    CloudEditionN CloudEditionN (Windows 11 SE N (202)
    Core Windows 10/11 Home (10/111)
    CoreCountrySpecific Windows 10/11 Home China (99)
    CoreN Windows 10/11 Home N (98)
    CoreSingleLanguage Windows 10/11 Home enkele taal (100)
    Education Windows 10/11 Education (121)
    EducationN Windows 10/11 Education (122)
    Enterprise Windows 10/11 Enterprise (4)
    EnterpriseEval Windows 10/11 Enterprise Evaluation (72)
    EnterpriseG Windows 10/11 Enterprise G (171)
    EnterpriseGN Windows 10/11 Enterprise G N (172)
    EnterpriseN Windows 10/11 Enterprise N (27)
    EnterpriseNEval Evaluatie van Windows 10/11 Enterprise N (84)
    Ondernemingen Windows 10 Enterprise LTSC (125)
    EnterpriseSEval Windows 10 Enterprise LTSC Evaluation (129)
    EnterpriseSN Windows 10 Enterprise LTSC N (126)
    Holografisch Windows 10 Holographic (136)
    IoTUAP Windows 10 IoT Core (123)
    IoTUAPCommercial Windows 10 IoT Core Commercial (131)
    IoTEnterprise Windows 10/11 IoT Enterprise (188)
    PPIPro Windows 10 TeamOS (119)
    Professional Windows 10/11 Professional (48)
    ProfessionalEducation Windows 10/11 Professional Education (164)
    ProfessionalEducationN Windows 10/11 Professional Education N (165)
    ProfessionalWorkstation Windows 10/11 Professional voor werkstation (161)
    ProfessionalN Windows 10/11 Professional voor werkstation N (162)
    ProfessionalSingleLanguage Windows 10/11 Professional Single Language (138)
    ServerRdsh Windows 10/11 Enterprise met meerdere sessies (175)

    Deze eigenschap is van toepassing op:

    • Windows 11
    • Windows 10

Tip

Gebruik in Windows PowerShell de Get-WmiObject -Class Win32_OperatingSystem |select operatingsystemSKU opdracht op een Windows-apparaat om het SKU-nummer te retourneren.

Eigenschappen van beheerde apps

U kunt de volgende app-eigenschappen gebruiken in uw beheerde app-filterregels:

  • appVersion (App-versie): maak een filterregel op basis van de door de client gerapporteerde toepassingsversie. Voer de volledige tekenreekswaarde in (met behulp van -eq, -ne, -in, -notIn operators) of gedeeltelijke waarde (met behulp van -startswith, -contains, -notcontains operators).

    Voorbeelden:

    • (app.appVersion -eq "14.2.1")
    • (app.appVersion -in ["10.15.3","10.14.2"])
    • (app.appVersion -startsWith "10.0")

    Deze eigenschap is van toepassing op:

    • Android
    • iOS/iPadOS
    • Windows

  • deviceManagementType (Apparaatbeheertype): maak een filterregel op basis van het Intune-apparaatbeheertype. Selecteer uit de volgende waarden met behulp van de -eq operators en -ne :

    Waarde Ondersteunde platformen
    Unmanaged Android
    iOS/iPadOS
    Managed iOS/iPadOS
    Android device administrator Android
    Android Enterprise Android
    AOSP userless devices Android
    AOSP user-associated devices Android
    Corporate-owned dedicated devices with Azure AD Shared mode Android

    Voorbeeld:

    • (app.deviceManagementType -eq "Unmanaged")

    Deze eigenschap is van toepassing:

    • Android
    • iOS/iPadOS

  • deviceManufacturer (Fabrikant): maak een filterregel op basis van de door de client gerapporteerde apparaatfabrikant. Voer de volledige tekenreekswaarde in (met behulp van -eq, -ne, -in, -notIn operators) of gedeeltelijke waarde (met behulp van -startswith, -contains, -notcontains operators).

    Voorbeelden:

    • (app.deviceManufacturer -eq "Microsoft")
    • (app.deviceManufacturer -startsWith "Micro")

    Deze eigenschap is van toepassing:

    • Android
    • iOS/iPadOS
    • Windows

  • deviceModel (Model): maak een filterregel op basis van het door de client gerapporteerde apparaatmodel. Voer de volledige tekenreekswaarde in (met behulp van -eq, -ne, -in, -notIn operators) of gedeeltelijke waarde (met behulp van -startswith, -contains, -notcontains operators).

    Voorbeelden:

    • (app.deviceModel -eq "Surface Duo")
    • (app.deviceModel -in ["Surface Duo", "Surface Duo 2"])
    • (app.deviceModel -startsWith "Surface Duo")

    Deze eigenschap is van toepassing op:

    • Android
    • iOS/iPadOS
    • Windows

  • operatingSystemVersion (Versie van besturingssysteem): maak een filterregel op basis van de versie van het Apparaatbesturingssysteem (OS) van Intune. Voer een versiewaarde in (met behulp van -eq, -ne, -gt, -ge, -lten operators -le ).

    Voorbeelden:

    • (app.operatingSystemVersion -eq 14.2.1)
    • (app.operatingSystemVersion -gt 10.0.22000.1000)
    • (app.operatingSystemVersion -le 10.0.22631.3235)

    Ga naar operatingSystemVersion supported operators (in dit artikel) voor een lijst met ondersteunde operators.

    Deze eigenschap is van toepassing op:

    • Android
    • iOS/iPadOS
    • Windows

    Opmerking

    De operatingSystemVersion eigenschap is in openbare preview. Ga naar Openbare preview in Microsoft Intune voor meer informatie over wat dat betekent.

  • osVersion (versie van besturingssysteem): maak een filterregel op basis van de door de client gerapporteerde versie van het besturingssysteem . Voer de volledige tekenreekswaarde in (met behulp van -eq, -ne, -in, -notIn operators) of gedeeltelijke waarde (met behulp van -startswith, -contains, -notcontains operators).

    Tip

    De osVersion eigenschap wordt afgeschaft. Gebruik in plaats daarvan de operatingSystemVersion eigenschap. Wanneer operatingSystemVersion de eigenschap algemeen beschikbaar (GA) is, wordt deze osVersion buiten gebruik gesteld en kun je geen nieuwe filters maken met deze eigenschap. Bestaande filters die worden gebruikt, osVersion blijven werken.

    Voorbeelden:

    • (app.osVersion -eq "14.2.1")
    • (app.osVersion -in ["10.15.3","10.14.2"])
    • (app.osVersion -startsWith "10.0")

    Deze eigenschap is van toepassing op:

    • Android
    • iOS/iPadOS
    • Windows

Geavanceerde regelbewerking

Wanneer u een filter maakt, kunt u handmatig eenvoudige of complexe regels maken in de regelsyntaxiseditor. U kunt ook algemene operators gebruiken, zoals or, containsen meer. De indeling is vergelijkbaar met dynamische Microsoft Entra-groepen: ([entity].[property name] [operation] [value]).

Wat u moet weten

  • De eigenschappen, bewerkingen en waarden zijn niet hoofdlettergevoelig.

  • Haakjes en geneste haakjes worden ondersteund.

  • U kunt of $Null als waarde gebruiken Null met de -Equals operatoren en-NotEquals.

  • Sommige geavanceerde syntaxisopties, zoals geneste haakjes, zijn alleen beschikbaar in de regelsyntaxiseditor. Als u geavanceerde expressies gebruikt in de regelsyntaxiseditor, is de opbouwfunctie voor regels uitgeschakeld.

    Voor meer informatie over de regelsyntaxiseditor en de opbouwfunctie voor regels gaat u naar Filters gebruiken bij het toewijzen van uw apps, beleid en profielen

Ondersteunde operators

U kunt de volgende operatoren gebruiken in de regelsyntaxiseditor:

  • Of: Gebruik voor alle waardetypen, met name bij het groeperen van eenvoudige regels.

    • Toegestane waarden: -or | or
    • Voorbeeld: (device.manufacturer -eq "Samsung") or (device.model -contains "Galaxy Note")

  • En: Gebruik voor alle waardetypen, met name bij het groeperen van eenvoudige regels.

    • Toegestane waarden: -and | and
    • Voorbeeld: (device.manufacturer -eq "Samsung") and (device.model -contains "Galaxy Note")

  • Gelijk aan: gebruik deze optie voor alle waardetypen, waaronder eenvoudige regels, tekenreeksen, matrices en meer.

    • Toegestane waarden: -eq | eq
    • Voorbeeld: (device.manufacturer -eq "Samsung") and (device.model -eq "Galaxy Note")

  • NotEquals: gebruik dit voor alle waardetypen, waaronder eenvoudige regels, tekenreeksen, matrices en meer.

    • Toegestane waarden: -ne | ne
    • Voorbeeld: (device.manufacturer -ne "Samsung") or (device.model -ne "Galaxy Note")

  • StartsWith: gebruik voor tekenreekswaardetypen.

    • Toegestane waarden: -startsWith | startsWith
    • Voorbeeld: (device.manufacturer -startsWith "Sams")

  • In: gebruik voor matrixwaardetypen, zoals ["1", "2"].

    • Toegestane waarden: -in | in
    • Voorbeeld: (device.manufacturer -in ["Samsung","Lenovo","Microsoft"])

  • NotIn: gebruik voor matrixwaardetypen, zoals ["1", "2"].

    • Toegestane waarden: -notIn | notIn
    • Voorbeeld: (device.manufacturer -notIn ["Samsung","Lenovo","Microsoft"])

  • Bevat: Gebruiken voor tekenreekswaardetypen.

    • Toegestane waarden: -contains | contains
    • Voorbeeld: (device.manufacturer -contains "Samsung")

  • NotContains: gebruik voor tekenreekswaardetypen.

    • Toegestane waarden: -notContains | notContains
    • Voorbeeld: (device.manufacturer -notContains "Samsung")

door operatingSystemVersion ondersteunde operators

Wanneer u de operatingSystemVersion (Operating System Version) eigenschap gebruikt, kunt u de volgende operatoren gebruiken in de regelsyntaxiseditor:

  • Gelijk aan: gebruik deze optie voor alle waardetypen, waaronder eenvoudige regels, tekenreeksen, matrices en meer.

    • Toegestane waarden: -eq | eq
    • Voorbeeld: (device.operatingSystemVersion -eq "10.0.22000.1000")

  • NotEquals: gebruik dit voor alle waardetypen, waaronder eenvoudige regels, tekenreeksen, matrices en meer.

    • Toegestane waarden: -ne | ne
    • Voorbeeld: (device.operatingSystemVersion -ne "10.0.22000.1000")

  • GreaterThan: gebruik voor typen versiewaarden.

    • Toegestane waarden: -gt | gt
    • Voorbeeld: (device.operatingSystemVersion -gt 10.0.22000.1000)

  • LessThan: gebruik voor typen versiewaarden.

    • Toegestane waarden: -lt | lt
    • Voorbeeld: (device.operatingSystemVersion -lt 10.0.22000.1000)

  • GreaterThanOrEquals: gebruik voor typen versiewaarden.

    • Toegestane waarden: -ge | ge
    • Voorbeeld: (device.operatingSystemVersion -ge 10.0.22000.1000)

  • LessThanOrEquals: gebruik voor typen versiewaarden.

    • Toegestane waarden: -le | le
    • Voorbeeld: (device.operatingSystemVersion -le 10.0.22000.1000)