Egenskaper, operatorer och regelredigering för appar och enheter när du skapar filter i Microsoft Intune
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
, contains
och 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
-eq
operatorerna ,-ne
,-notIn
-in
):- amd64
- x86
- arm64
- okänd
För macOS är alternativen (med
-eq
operatorerna ,-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äljPersonal
,Corporate
eller 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-eq
operatorerna ,-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äljTrue
,False
eller 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ändoperatingSystemVersion
i stället egenskapen . NäroperatingSystemVersion
ä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änderosVersion
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 exempel14.1.2a
. När du skapar filter för Apple-enheter ska du inte inkludera SPV i regelsyntaxenOSversion
.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/iPadOSManaged
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ändoperatingSystemVersion
i stället egenskapen . NäroperatingSystemVersion
ä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änderosVersion
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
, contains
och 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")
-
Tillåtna värden:
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")
-
Tillåtna värden:
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")
-
Tillåtna värden:
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")
-
Tillåtna värden:
StartsWith: Används för strängvärdetyper.
-
Tillåtna värden:
-startsWith
|startsWith
-
Exempel:
(device.manufacturer -startsWith "Sams")
-
Tillåtna värden:
I: Används för matrisvärdetyper, till exempel
["1", "2"]
.-
Tillåtna värden:
-in
|in
-
Exempel:
(device.manufacturer -in ["Samsung","Lenovo","Microsoft"])
-
Tillåtna värden:
NotIn: Används för matrisvärdetyper, till exempel
["1", "2"]
.-
Tillåtna värden:
-notIn
|notIn
-
Exempel:
(device.manufacturer -notIn ["Samsung","Lenovo","Microsoft"])
-
Tillåtna värden:
Innehåller: Används för strängvärdestyper.
-
Tillåtna värden:
-contains
|contains
-
Exempel:
(device.manufacturer -contains "Samsung")
-
Tillåtna värden:
NotContains: Används för strängvärdestyper.
-
Tillåtna värden:
-notContains
|notContains
-
Exempel:
(device.manufacturer -notContains "Samsung")
-
Tillåtna värden:
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")
-
Tillåtna värden:
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")
-
Tillåtna värden:
GreaterThan: Används för versionsvärdetyper.
-
Tillåtna värden:
-gt
|gt
-
Exempel:
(device.operatingSystemVersion -gt 10.0.22000.1000)
-
Tillåtna värden:
LessThan: Används för versionsvärdetyper.
-
Tillåtna värden:
-lt
|lt
-
Exempel:
(device.operatingSystemVersion -lt 10.0.22000.1000)
-
Tillåtna värden:
GreaterThanOrEquals: Används för versionsvärdetyper.
-
Tillåtna värden:
-ge
|ge
-
Exempel:
(device.operatingSystemVersion -ge 10.0.22000.1000)
-
Tillåtna värden:
LessThanOrEquals: Används för versionsvärdetyper.
-
Tillåtna värden:
-le
|le
-
Exempel:
(device.operatingSystemVersion -le 10.0.22000.1000)
-
Tillåtna värden: