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 30 augustus 2024. Na die datum zijn apparaatinschrijving, technische ondersteuning, bugfixes en beveiligingspatches niet meer beschikbaar. Als u momenteel apparaatbeheer gebruikt, raden we u aan over te schakelen naar een andere Android-beheeroptie in Intune voordat de ondersteuning wordt beëindigd. Lees 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:

  • 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

  • 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

  • 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

  • osVersion (versie van het 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).

    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 .

  • 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

  • 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

  • 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

  • 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 gekoppeld 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 Intune filters zijn van toepassing op Intune. Ze zijn niet van toepassing op Microsoft Entra ID.

  • 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 . In het Intune-beheercentrum worden de SKU-namen niet weergegeven. 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 Ondernemingsevaluatie (72)
    EnterpriseG Windows 10/11 Enterprise G (171)
    EnterpriseGN Windows 10/11 Enterprise G N (172)
    EnterpriseN Windows 10/11 Enterprise N (27)
    EnterpriseNEval Windows 10/11 Enterprise N Evaluation (84)
    Ondernemingen Windows 10 Enterprise LTSC (125)
    EnterpriseSEval Windows 10 Enterprise LTSC-evaluatie (129)
    EnterpriseSN Windows 10 Enterprise LTSC N (126)
    Holografische Windows 10 Holographic (136)
    IoTUAP Windows 10 IoT Core (123)
    IoTUAPCommercial Windows 10 IoT Core Commercieel (131)
    IoTEnterprise Windows 10/11 IoT Enterprise (188)
    PPIPro Windows 10 TeamOS (119)
    Professional Windows 10/11 Professional (48)
    ProfessionalEducation Windows 10/11 Beroepsonderwijs (164)
    ProfessionalEducationN Windows 10/11 Beroepsonderwijs 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 (Apparaatbeheer type): maak op Intune ingeschreven apparaten een filterregel op basis van het Intune apparaatbeheertype. Apparaten moeten worden Intune ingeschreven om deze app-eigenschap te kunnen gebruiken. 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

  • 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).

    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 Microsoft Entra dynamische 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")

Volgende stappen