Egenskaper, operatorer och regelredigering för appar och enheter när du skapar filter i Microsoft Intune

  • Artikel

När du skapar en app, en efterlevnadsprincip eller en konfigurationsprofil tilldelar du appen eller principen till grupper (användare eller enheter). När du tilldelar appen eller principen kan du också använda tilldelningsfilter.

Du kan använda filter på hanterade enheter (enheter som registrerats i Intune) och hanterade appar (appar som hanteras av Intune).

När du skapar ett filter anger du de app- eller enhetsegenskaper som ska användas i filtret. Till exempel:

  • I filtret för den hanterade enheten anger du enhetstillverkaren så att principen endast gäller för Microsoft-enheter.
  • I filtret för den hanterade appen anger du os-versionen så att principen endast gäller för enheter med den specifika os-versionen.

Avancerad regelredigering är också tillgänglig. Du kan använda vanliga operatorer, till exempel and, containsoch startsWith för att skapa uttryck. Dessa uttryck sparas och används i filtret.

Den här artikeln beskriver de olika egenskaperna för hanterade enheter, egenskaper för hanterade appar och operatorer som du kan använda i dina filter och ger exempel.

Viktigt

Microsoft Intune upphör stödet för hantering av Android-enhetsadministratörer på enheter med åtkomst till Google Mobile Services (GMS) den 31 december 2024. Efter det datumet är enhetsregistrering, teknisk support, felkorrigeringar och säkerhetskorrigeringar otillgängliga. Om du för närvarande använder hantering av enhetsadministratörer rekommenderar vi att du växlar till ett annat Android-hanteringsalternativ i Intune innan supporten upphör. Mer information finns i Avsluta stöd för Android-enhetsadministratör på GMS-enheter.

Egenskaper för hanterade enheter

Du kan använda följande enhetsegenskaper i dina filterregler för hanterade enheter:

  • cpuArchitecture (CPU-arkitektur): Skapa en filterregel baserat på intune-enhetens processorarkitekturegenskap.

    För Windows är dina alternativ (med -eqoperatorerna , -ne, -notIn-in):

    • amd64
    • x86
    • arm64
    • okänd

    För macOS är alternativen (med -eqoperatorerna , -ne, -in-notIn ):

    • x64
    • arm64
    • okänd

    Exempel:

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

    Den här egenskapen gäller för:

    • macOS
    • Windows 11
    • Windows 10

    Obs!

    För närvarande stöder cpuArchitecture inte registreringsscenarier egenskapen. Support kommer att läggas till i en framtida uppdatering (ingen ETA).

  • deviceCategory (Enhetskategori): Skapa en filterregel baserat på egenskapen Intune-enhetskategori. Ange det fullständiga strängvärdet (med operatorerna -eq, -ne, -in-notIn eller det partiella värdet (med operatorerna -startswith, -contains-notcontains ).

    Exempel:

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

    Den här egenskapen gäller för:

    • Android-enhetsadministratör
    • Android enterprise
    • Android (AOSP)
    • iOS/iPadOS
    • macOS
    • Windows 11
    • Windows 10

  • deviceName (Enhetsnamn): Skapa en filterregel baserat på egenskapen Intune-enhetsnamn. Ange ett strängvärde för enhetens fullständiga namn (med operatorerna -eq, -ne, -in-notIn eller partiellt värde (med operatorerna -startswith, -contains-notcontains ).

    Exempel:

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

    Den här egenskapen gäller för:

    • Android-enhetsadministratör
    • Android enterprise
    • Android (AOSP)
    • iOS/iPadOS
    • macOS
    • Windows 11
    • Windows 10

  • deviceOwnership (Ägarskap): Skapa en filterregel baserat på enhetens ägarskapsegenskap i Intune. Välj Personal, Corporateeller okända värden med operatorerna -eq och -ne .

    Exempel:

    • (device.deviceOwnership -eq "Personal")

    Den här egenskapen gäller för:

    • Android-enhetsadministratör
    • Android enterprise
    • Android (AOSP)
    • iOS/iPadOS
    • macOS
    • Windows 11
    • Windows 10

  • deviceTrustType (Microsoft Entra-kopplingstyp): Skapa en filterregel baserat på enhetens Microsoft Entra-kopplingstyp. Välj mellan Azure AD-anslutna, Azure AD-registrerade, Hybrid Azure AD-anslutna eller Okända värden (med -eqoperatorerna , -ne, -in-notIn ).

    Exempel:

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

    Den här egenskapen gäller för:

    • Windows 11
    • Windows 10

    Obs!

    Egenskapen deviceTrustType finns i Microsoft Entra ID och Intune. Värdena i den här artikeln om Intune-filter gäller för Intune. De gäller inte för Microsoft Entra-ID.

  • enrollmentProfileName (Namn på registreringsprofil): Skapa en filterregel baserat på namnet på registreringsprofilen. Den här egenskapen tillämpas på en enhet när enheten registreras. Det är ett strängvärde som du har skapat och matchar Windows Autopilot, Apple Automated Device Enrollment (ADE) eller Google-registreringsprofilen som tillämpas på enheten. Om du vill se dina registreringsprofilnamn loggar du in på Administrationscenter för Intune och går till Enheter>Registrera enheter.

    Ange det fullständiga strängvärdet (med operatorerna -eq, -ne, -in-notIn eller det partiella värdet (med operatorerna -startswith, -contains-notcontains ).

    Exempel:

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

    Den här egenskapen gäller för:

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

  • IsRooted (Rotad eller jailbrokad): Skapa en filterregel baserat på enhetens rotade (Android) eller jailbrokade enhetsegenskap (iOS/iPadOS). Välj True, Falseeller okända värden med operatorerna -eq och -ne .

    Exempel:

    • (device.isRooted -eq "True")

    Den här egenskapen gäller för:

    • Android-enhetsadministratör
    • Android Enterprise (endast arbetsprofil)
    • Android (AOSP)
    • iOS/iPadOS

  • manufacturer (Tillverkare): Skapa en filterregel baserat på intune-enhetstillverkarens egenskap. Ange det fullständiga strängvärdet (med operatorerna -eq, -ne, -in-notIn eller det partiella värdet (med operatorerna -startswith, -contains-notcontains ).

    Exempel:

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

    Den här egenskapen gäller för:

    • Android-enhetsadministratör
    • Android enterprise
    • Android (AOSP)
    • iOS/iPadOS
    • macOS
    • Windows 11
    • Windows 10

  • model (Modell): Skapa en filterregel baserat på intune-enhetsmodellegenskapen. Ange det fullständiga strängvärdet (med operatorerna -eq, -ne, -in-notIn eller det partiella värdet (med operatorerna -startswith, -contains-notcontains ).

    För iOS/iPadOS- och macOS-enheter använder du modellen, inte produktnamnet. Endast modellen känns igen för Apple-enheter. För iPhone 8-enheter anger du till exempel modellen som iPhone 8.

    Exempel:

    • (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")

    Den här egenskapen gäller för:

    • Android-enhetsadministratör
    • Android enterprise
    • Android (AOSP)
    • iOS/iPadOS
    • macOS
    • Windows 11
    • Windows 10

  • operatingSystemVersion (Operativsystemversion): Skapa en filterregel baserat på Intune-enhetens operativsystemversion (OS). Ange ett versionsvärde (med operatorerna -eq, -ne, -gt, -ge, -lt). -le

    Exempel:

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

    En lista över operatorer som stöds finns i operatorer som stöds av operatingSystemVersion (i den här artikeln).

    Den här egenskapen gäller för:

    • Android-enhetsadministratör
    • Android enterprise
    • Android (AOSP)
    • iOS/iPadOS
    • macOS
    • Windows 11
    • Windows 10

    Obs!

    Egenskapen operatingSystemVersion finns i offentlig förhandsversion. Mer information om vad det innebär finns i Offentlig förhandsversion i Microsoft Intune.

  • osVersion (OS-version): Skapa en filterregel baserat på Intune-enhetens operativsystemversion (OS). Ange det fullständiga strängvärdet (med operatorerna -eq, -ne, -in-notIn eller det partiella värdet (med operatorerna -startswith, -contains-notcontains ).

    Tips

    Egenskapen osVersion håller på att bli inaktuell. Använd operatingSystemVersion i stället egenskapen . När operatingSystemVersion är allmänt tillgängligt (GA) osVersion tas egenskapen ur bruk och du kan inte skapa nya filter med den här egenskapen. Befintliga filter som använder osVersion fortsätter att fungera.

    Exempel:

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

    Den här egenskapen gäller för:

    • Android-enhetsadministratör
    • Android enterprise
    • Android (AOSP)
    • iOS/iPadOS
    • macOS
    • Windows 11
    • Windows 10

    Obs!

    För Apple-enheter OSversion innehåller egenskapen inte Apples SPV-information (Security Patch Version). SPV är bokstaven efter versionsnumret, till exempel 14.1.2a. När du skapar filter för Apple-enheter ska du inte inkludera SPV i regelsyntaxen OSversion .

  • operatingSystemSKU (Operativsystem-SKU): Skapa en filterregel baserat på enhetens SKU för Windows-klientens OPERATIVSYSTEM. Ange det fullständiga strängvärdet (med operatorerna -eq, -ne, -in-notIn eller det partiella värdet (med operatorerna -startswith, -contains-notcontains ).

    Exempel:

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

    Du kan använda följande värden som stöds för SKU-egenskapen för operativsystem . Intune-administrationscentret visar inte SKU-namnen. Se därför till att använda de värden som stöds i följande tabell:

    Värde som stöds OS SKU-definition
    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 single language (100)
    Education Windows 10/11 Education (121)
    EducationN Windows 10/11 Education (122)
    Enterprise Windows 10/11 Enterprise (4)
    EnterpriseEval Windows 10/11 Enterprise-utvärdering (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-utvärdering (84)
    Företag Windows 10 Enterprise LTSC (125)
    EnterpriseSEval Windows 10 Enterprise LTSC-utvärdering (129)
    EnterpriseSN Windows 10 Enterprise LTSC N (126)
    Holografisk 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)
    Professionell 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 för arbetsstation (161)
    ProfessionalN Windows 10/11 Professional för arbetsstation N (162)
    ProfessionalSingleLanguage Windows 10/11 Professional Single Language (138)
    ServerRdsh Windows 10/11 Enterprise multi-session (175)

    Den här egenskapen gäller för:

    • Windows 11
    • Windows 10

Tips

I Windows PowerShell använder du Get-WmiObject -Class Win32_OperatingSystem |select operatingsystemSKU kommandot på en Windows-enhet för att returnera SKU-numret.

Egenskaper för hanterade appar

Du kan använda följande appegenskaper i dina filterregler för hanterade appar:

  • appVersion (Appversion): Skapa en filterregel baserat på den klientrapporterade programversionen. Ange det fullständiga strängvärdet (med operatorerna -eq, -ne, -in-notIn eller det partiella värdet (med operatorerna -startswith, -contains-notcontains ).

    Exempel:

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

    Den här egenskapen gäller för:

    • Android
    • iOS/iPadOS
    • Windows

  • deviceManagementType (Typ av enhetshantering): Skapa en filterregel baserat på intune-enhetshanteringstypen. Välj mellan följande värden med operatorerna -eq och -ne :

    Värde Plattformar som stöds
    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

    Exempel:

    • (app.deviceManagementType -eq "Unmanaged")

    Den här egenskapen gäller:

    • Android
    • iOS/iPadOS

  • deviceManufacturer (Tillverkare): Skapa en filterregel baserat på den klientrapporterade enhetstillverkaren. Ange det fullständiga strängvärdet (med operatorerna -eq, -ne, -in-notIn eller det partiella värdet (med operatorerna -startswith, -contains-notcontains ).

    Exempel:

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

    Den här egenskapen gäller:

    • Android
    • iOS/iPadOS
    • Windows

  • deviceModel (Modell): Skapa en filterregel baserat på den klientrapporterade enhetsmodellen. Ange det fullständiga strängvärdet (med operatorerna -eq, -ne, -in-notIn eller det partiella värdet (med operatorerna -startswith, -contains-notcontains ).

    Exempel:

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

    Den här egenskapen gäller för:

    • Android
    • iOS/iPadOS
    • Windows

  • operatingSystemVersion (Operativsystemversion): Skapa en filterregel baserat på Intune-enhetens operativsystemversion (OS). Ange ett versionsvärde (med operatorerna -eq, -ne, -gt, -ge, -lt). -le

    Exempel:

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

    En lista över operatorer som stöds finns i operatorer som stöds av operatingSystemVersion (i den här artikeln).

    Den här egenskapen gäller för:

    • Android
    • iOS/iPadOS
    • Windows

    Obs!

    Egenskapen operatingSystemVersion finns i offentlig förhandsversion. Mer information om vad det innebär finns i Offentlig förhandsversion i Microsoft Intune.

  • osVersion (OS-version): Skapa en filterregel baserat på klientens rapporterade operativsystemversion (OS). Ange det fullständiga strängvärdet (med operatorerna -eq, -ne, -in-notIn eller det partiella värdet (med operatorerna -startswith, -contains-notcontains ).

    Tips

    Egenskapen osVersion håller på att bli inaktuell. Använd operatingSystemVersion i stället egenskapen . När operatingSystemVersion är allmänt tillgängligt (GA) osVersion tas egenskapen ur bruk och du kan inte skapa nya filter med den här egenskapen. Befintliga filter som använder osVersion fortsätter att fungera.

    Exempel:

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

    Den här egenskapen gäller för:

    • Android
    • iOS/iPadOS
    • Windows

Avancerad regelredigering

När du skapar ett filter kan du manuellt skapa enkla eller komplexa regler i regelsyntaxredigeraren. Du kan också använda vanliga operatorer, till exempel or, containsoch mycket mer. Formatet liknar dynamiska Microsoft Entra-grupper: ([entity].[property name] [operation] [value]).

Vad du behöver veta

  • Egenskaper, åtgärder och värden är skiftlägesokänsliga.

  • Parenteser och kapslade parenteser stöds.

  • Du kan använda Null eller $Null som ett värde med operatorerna -Equals och -NotEquals .

  • Vissa avancerade syntaxalternativ, till exempel kapslade parenteser, är bara tillgängliga i regelsyntaxredigeraren. Om du använder avancerade uttryck i regelsyntaxredigeraren inaktiveras regelverktyget.

    Mer information om regelsyntaxredigeraren och regelverktyget finns i Använda filter när du tilldelar appar, principer och profiler

Operatorer som stöds

Du kan använda följande operatorer i regelsyntaxredigeraren:

  • Eller: Använd för alla värdetyper, särskilt när du grupperar enkla regler.

    • Tillåtna värden: -or | or
    • Exempel: (device.manufacturer -eq "Samsung") or (device.model -contains "Galaxy Note")

  • Och: Använd för alla värdetyper, särskilt när du grupperar enkla regler.

    • Tillåtna värden: -and | and
    • Exempel: (device.manufacturer -eq "Samsung") and (device.model -contains "Galaxy Note")

  • Lika med: Används för alla värdetyper, inklusive enkla regler, strängar, matriser med mera.

    • Tillåtna värden: -eq | eq
    • Exempel: (device.manufacturer -eq "Samsung") and (device.model -eq "Galaxy Note")

  • NotEquals: Används för alla värdetyper, inklusive enkla regler, strängar, matriser med mera.

    • Tillåtna värden: -ne | ne
    • Exempel: (device.manufacturer -ne "Samsung") or (device.model -ne "Galaxy Note")

  • StartsWith: Används för strängvärdetyper.

    • Tillåtna värden: -startsWith | startsWith
    • Exempel: (device.manufacturer -startsWith "Sams")

  • I: Används för matrisvärdetyper, till exempel ["1", "2"].

    • Tillåtna värden: -in | in
    • Exempel: (device.manufacturer -in ["Samsung","Lenovo","Microsoft"])

  • NotIn: Används för matrisvärdetyper, till exempel ["1", "2"].

    • Tillåtna värden: -notIn | notIn
    • Exempel: (device.manufacturer -notIn ["Samsung","Lenovo","Microsoft"])

  • Innehåller: Används för strängvärdestyper.

    • Tillåtna värden: -contains | contains
    • Exempel: (device.manufacturer -contains "Samsung")

  • NotContains: Används för strängvärdestyper.

    • Tillåtna värden: -notContains | notContains
    • Exempel: (device.manufacturer -notContains "Samsung")

operatorer som stöds av operatingSystemVersion

När du använder egenskapen operatingSystemVersion (Operating System Version) kan du använda följande operatorer i regelsyntaxredigeraren:

  • Lika med: Används för alla värdetyper, inklusive enkla regler, strängar, matriser med mera.

    • Tillåtna värden: -eq | eq
    • Exempel: (device.operatingSystemVersion -eq "10.0.22000.1000")

  • NotEquals: Används för alla värdetyper, inklusive enkla regler, strängar, matriser med mera.

    • Tillåtna värden: -ne | ne
    • Exempel: (device.operatingSystemVersion -ne "10.0.22000.1000")

  • GreaterThan: Används för versionsvärdetyper.

    • Tillåtna värden: -gt | gt
    • Exempel: (device.operatingSystemVersion -gt 10.0.22000.1000)

  • LessThan: Används för versionsvärdetyper.

    • Tillåtna värden: -lt | lt
    • Exempel: (device.operatingSystemVersion -lt 10.0.22000.1000)

  • GreaterThanOrEquals: Används för versionsvärdetyper.

    • Tillåtna värden: -ge | ge
    • Exempel: (device.operatingSystemVersion -ge 10.0.22000.1000)

  • LessThanOrEquals: Används för versionsvärdetyper.

    • Tillåtna värden: -le | le
    • Exempel: (device.operatingSystemVersion -le 10.0.22000.1000)