Condividi tramite

Proprietà dell'app e del dispositivo, operatori e modifica delle regole durante la creazione di filtri di assegnazione in Microsoft Intune

I filtri di assegnazione in Intune consentono di perfezionare la destinazione di app e criteri in base alle proprietà del dispositivo e dell'app. Questo articolo di riferimento descrive le proprietà, gli operatori e la sintassi delle regole che è possibile usare per la creazione di filtri per dispositivi gestiti e app gestite.

Quando si crea un'app, un criterio di conformità o un profilo di configurazione, l'app o i criteri vengono assegnati a gruppi (utenti o dispositivi). I filtri di assegnazione consentono di limitare l'ambito delle assegnazioni in base a criteri specifici.

È possibile usare i filtri di assegnazione nei dispositivi gestiti (dispositivi registrati in Intune) e nelle app gestite (app gestite da Intune). Quando si crea un filtro, si specificano proprietà come il produttore del dispositivo, la versione del sistema operativo o il profilo di registrazione e si usano gli operatori per compilare espressioni di regola, ad esempio startsWith e contains.

Questo articolo fornisce un riferimento completo per le proprietà dei dispositivi gestiti, le proprietà dell'app gestita e gli operatori supportati che è possibile usare nei filtri di assegnazione e include esempi pratici.

Importante

La gestione dell'amministratore di dispositivi Android è deprecata e non è più disponibile per i dispositivi con accesso a Google Mobile Services (GMS). Se attualmente si usa la gestione da da parte dell'utente, è consigliabile passare a un'altra opzione di gestione Android. La documentazione di supporto e guida rimane disponibile per alcuni dispositivi Android 15 e versioni precedenti senza GMS. Per altre informazioni, vedere Termina il supporto per l'amministratore di dispositivi Android nei dispositivi GMS.

Proprietà disponibili

È possibile usare i filtri di assegnazione nei dispositivi gestiti (dispositivi registrati in Intune) e nelle app gestite (app gestite da Intune). In questa sezione sono elencate le proprietà disponibili.

È possibile usare le proprietà del dispositivo seguenti nelle regole di filtro del dispositivo gestito:

  • cpuArchitecture (Architettura CPU): creare una regola di filtro basata sulla proprietà dell'architettura DELLA CPU del dispositivo Intune.

    Per Windows, le opzioni sono (con -eqoperatori , -ne, -in): -notIn

    • amd64
    • x86
    • arm64
    • sconosciuto

    Per macOS, le opzioni sono (con -eqoperatori , -ne, -in): -notIn

    • x64
    • arm64
    • sconosciuto

    Esempi:

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

    Questa proprietà si applica a:

    • macOS
    • Windows

    Nota

    Attualmente, gli scenari di registrazione non supportano la cpuArchitecture proprietà . Il supporto verrà aggiunto in un aggiornamento futuro (senza ETA).

  • deviceCategory (Categoria dispositivo): creare una regola di filtro in base alla proprietà della categoria di dispositivi Intune. Immettere il valore stringa completo (usando -eq, -ne, -in, -notIn operatori) o il valore parziale (usando -startswith, -contains, -notcontains operatori ).

    Esempi:

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

    Questa proprietà si applica a:

    • Amministratore del dispositivo Android
    • Android Enterprise
    • Android
    • iOS/iPadOS
    • macOS
    • Windows

  • deviceManagementType (Gestione dispositivi Tipo): creare una regola di filtro basata sul tipo di gestione dei dispositivi Intune. Selezionare i valori seguenti usando gli -eq operatori e -ne :

    Valore Piattaforme supportate
    Corporate-owned dedicated devices with Entra ID Shared mode Android
    Corporate-owned dedicated devices without Entra ID Shared mode Android
    Corporate-owned with work profile Android
    Corporate-owned fully managed Android
    Personally-owned work profile Android
    AOSP user-associated devices Android
    AOSP userless devices Android

    Esempio:

    • (app.deviceManagementType -eq "Corporate-owned dedicated devices without Entra ID Shared mode")

    Questa proprietà si applica:

    • Android

  • deviceName (Nome dispositivo): creare una regola di filtro in base alla proprietà Intune nome dispositivo. Immettere un valore stringa per il nome completo del dispositivo (usando -eq, , -ne-in, -notIn operatori) o un valore parziale (usando -startswithoperatori , -contains, -notcontains ).

    Esempi:

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

    Questa proprietà si applica a:

    • Amministratore del dispositivo Android
    • Android Enterprise
    • Android
    • iOS/iPadOS
    • macOS
    • Windows

  • deviceOwnership (Proprietà): creare una regola di filtro in base alla proprietà di proprietà del dispositivo in Intune. Selezionare Personal, Corporateo valori sconosciuti usando gli -eq operatori e -ne .

    Esempio:

    • (device.deviceOwnership -eq "Personal")

    Questa proprietà si applica a:

    • Amministratore del dispositivo Android
    • Android Enterprise
    • Android
    • iOS/iPadOS
    • macOS
    • Windows

  • deviceTrustType (Microsoft Entra tipo join): creare una regola di filtro in base al tipo di join Microsoft Entra del dispositivo. Scegliere tra Azure aggiunto ad AD, Azure ad registrato, ibrido Azure aggiunto ad AD o valori sconosciuti (con -eqoperatori , -ne, -in-notIn ).

    Esempi:

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

    Questa proprietà si applica a:

    • Windows

    Nota

    La deviceTrustType proprietà esiste in Microsoft Entra ID e Intune. I valori in questo articolo sui filtri di assegnazione Intune si applicano a Intune. Non si applicano a Microsoft Entra ID.

  • enrollmentProfileName (Nome profilo di registrazione): creare una regola di filtro in base al nome del profilo di registrazione. Questa proprietà viene applicata a un dispositivo quando il dispositivo viene registrato. Si tratta di un valore stringa creato dall'utente e corrisponde al profilo di registrazione automatica di Windows, Apple Automated Device Enrollment (ADE) o Google applicato al dispositivo. Per visualizzare i nomi dei profili di registrazione, accedere all'interfaccia di amministrazione Intune e passare a Dispositivi>Registrare dispositivi.

    Immettere il valore stringa completo (usando -eq, -ne, -in, -notIn operatori) o il valore parziale (usando -startswith, -contains, -notcontains operatori ).

    Esempi:

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

    Questa proprietà si applica a:

    • Android Enterprise
    • Android
    • iOS/iPadOS
    • Windows

  • IsRooted (Rooted o jailbroken): creare una regola di filtro basata sulla proprietà del dispositivo rooted (Android) o jailbroken (iOS/iPadOS) del dispositivo. Selezionare True, Falseo valori sconosciuti usando gli -eq operatori e -ne .

    Esempio:

    • (device.isRooted -eq "True")

    Questa proprietà si applica a:

    • Amministratore del dispositivo Android
    • Android Enterprise (solo profilo di lavoro)
    • Android
    • iOS/iPadOS

  • manufacturer (Produttore): creare una regola di filtro in base alla proprietà Intune produttore del dispositivo. Immettere il valore stringa completo (usando -eq, -ne, -in, -notIn operatori) o il valore parziale (usando -startswith, -contains, -notcontains operatori ).

    Esempi:

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

    Questa proprietà si applica a:

    • Amministratore del dispositivo Android
    • Android Enterprise
    • Android
    • iOS/iPadOS
    • macOS
    • Windows

  • model (Modello): creare una regola di filtro in base alla proprietà del modello di dispositivo Intune. Immettere il valore stringa completo (usando -eq, -ne, -in, -notIn operatori) o il valore parziale (usando -startswith, -contains, -notcontains operatori ).

    Per i dispositivi iOS/iPadOS e macOS, usare il modello, non il nome del prodotto. Solo il modello viene riconosciuto per i dispositivi Apple. Ad esempio, per i dispositivi iPhone 8 immettere il modello come iPhone 8.

    Esempi:

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

    Nota

    I modelli di iPad Pro meno recenti usano il simbolo doppio primo (") invece di pollice. Se si usano operatori di valori stringa completi, questo simbolo può causare la mancata valutazione corretta dei filtri di assegnazione. Per questi modelli, usare operatori di valori parziali per assicurarsi che i filtri di assegnazione valutino il modello come previsto. Per i dispositivi modello, ad esempio, iPad Pro (12.9")(2nd generation) è possibile usare (device.model -contains "iPad Pro 12.9") e (device.model -contains "(2nd generation)").

    Questa proprietà si applica a:

    • Amministratore del dispositivo Android
    • Android Enterprise
    • Android
    • iOS/iPadOS
    • macOS
    • Windows

  • operatingSystemVersion (Versione del sistema operativo): creare una regola di filtro basata sulla versione del sistema operativo del dispositivo Intune. Immettere un valore di versione (usando -eqoperatori , -ne, -gt-ge, , -lt, -le ).

    Esempi:

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

    Per un elenco degli operatori supportati, vedere Operatori supportati per operatingSystemVersion (in questo articolo).

    Questa proprietà si applica a:

    • Amministratore del dispositivo Android
    • Android Enterprise
    • Android
    • iOS/iPadOS
    • macOS
    • Windows

    Nota

    La operatingSystemVersion proprietà è in anteprima pubblica. Per altre informazioni sul significato, passare all'anteprima pubblica in Microsoft Intune.

  • osVersion (Versione del sistema operativo): creare una regola di filtro basata sulla versione del sistema operativo del dispositivo Intune. Immettere il valore stringa completo (usando -eq, -ne, -in, -notIn operatori) o il valore parziale (usando -startswith, -contains, -notcontains operatori ).

    Consiglio

    La osVersion proprietà è deprecata. Utilizzare invece la operatingSystemVersion proprietà . Quando operatingSystemVersion è disponibile a livello generale, la osVersion proprietà verrà ritirata e non sarà possibile creare nuovi filtri di assegnazione usando questa proprietà. I filtri di assegnazione esistenti che usano osVersion continuano a funzionare.

    Esempi:

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

    Questa proprietà si applica a:

    • Amministratore del dispositivo Android
    • Android Enterprise
    • Android
    • iOS/iPadOS
    • macOS
    • Windows

    Nota

    Per i dispositivi Apple, la OSversion proprietà non include le informazioni SPV (Security Patch Version) di Apple. SPV è la lettera dopo il numero di versione, ad esempio 14.1.2a. Quando si creano filtri di assegnazione per i dispositivi Apple, non includere il protocollo SPV nella sintassi della OSversion regola.

  • operatingSystemSKU (SKU del sistema operativo):: creare una regola di filtro basata sullo SKU del sistema operativo del client Windows del dispositivo. Immettere il valore stringa completo (usando -eq, -ne, -in, -notIn operatori) o il valore parziale (usando -startswith, -contains, -notcontains operatori ).

    Esempi:

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

    È possibile usare i valori supportati seguenti per la proprietà SKU del sistema operativo . L'interfaccia di amministrazione Intune non visualizza i nomi degli SKU. Assicurarsi quindi di usare i valori supportati nella tabella seguente:

    Valore supportato Definizione dello SKU del sistema operativo
    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 Lingua singola home (100)
    Funzionalità didattiche Windows 10/11 Istruzione (121)
    EducationN Windows 10/11 Istruzione (122)
    Aziendale Windows 10/11 Enterprise (4)
    EnterpriseEval Windows 10/11 Valutazione aziendale (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)
    Imprese Windows 10 Enterprise LTSC (125)
    EnterpriseSEval Windows 10 Enterprise valutazione LTSC (129)
    EnterpriseSN Windows 10 Enterprise LTSC N (126)
    Olografico Windows 10 Holographic (136)
    IoTUAP Windows 10 IoT Core (123)
    IoTUAPCommercial Windows 10 IoT Core Commerciale (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 per workstation (161)
    ProfessionalN Windows 10/11 Professional per workstation N (162)
    ProfessionalSingleLanguage Windows 10/11 Professional Single Language (138)
    ServerRdsh Windows 10/11 Enterprise multisessione (175)

    Questa proprietà si applica a:

    • Windows

Nota

  • In Windows PowerShell usare il Get-WmiObject -Class Win32_OperatingSystem |select operatingsystemSKU comando in un dispositivo Windows per restituire il numero di SKU.
  • Il 14 ottobre 2025 Windows 10 raggiunto la fine del supporto e non riceverà aggiornamenti di qualità e funzionalità. Windows 10 è una versione consentita in Intune. I dispositivi che eseguono questa versione possono comunque registrarsi in Intune e usare le funzionalità idonee, ma le funzionalità non saranno garantite e possono variare.

Modifica avanzata delle regole

Quando si crea un filtro, è possibile creare manualmente regole semplici o complesse nell'editor della sintassi delle regole. È anche possibile usare operatori comuni, ad oresempio , containse altro ancora. Il formato è simile a Microsoft Entra gruppi dinamici: ([entity].[property name] [operation] [value]).

Informazioni importanti

  • Le proprietà, le operazioni e i valori non fanno distinzione tra maiuscole e minuscole.

  • Le parentesi e le parentesi annidate sono supportate.

  • È possibile usare Null o $Null come valore con gli -Equals operatori e -NotEquals .

  • Alcune opzioni di sintassi avanzate, ad esempio le parentesi annidate, sono disponibili solo nell'editor della sintassi delle regole. Se si usano espressioni avanzate nell'editor della sintassi delle regole, il generatore di regole è disabilitato.

    Per altre informazioni sull'editor della sintassi delle regole e sul generatore di regole, vedere Usare i filtri durante l'assegnazione di app, criteri e profili

Operatori supportati

È possibile usare gli operatori seguenti nell'editor della sintassi delle regole:

  • Oppure: usare per tutti i tipi di valore, soprattutto quando si raggruppano regole semplici.

    • Valori consentiti: -or | or
    • Esempio: (device.manufacturer -eq "Samsung") or (device.model -contains "Galaxy Note")

  • E: usare per tutti i tipi di valore, soprattutto quando si raggruppano regole semplici.

    • Valori consentiti: -and | and
    • Esempio: (device.manufacturer -eq "Samsung") and (device.model -contains "Galaxy Note")

  • Uguale a: usare per tutti i tipi di valore, tra cui regole semplici, stringhe, matrici e altro ancora.

    • Valori consentiti: -eq | eq
    • Esempio: (device.manufacturer -eq "Samsung") and (device.model -eq "Galaxy Note")

  • NotEquals: usare per tutti i tipi di valore, incluse regole semplici, stringhe, matrici e altro ancora.

    • Valori consentiti: -ne | ne
    • Esempio: (device.manufacturer -ne "Samsung") or (device.model -ne "Galaxy Note")

  • StartsWith: usare per i tipi di valore stringa.

    • Valori consentiti: -startsWith | startsWith
    • Esempio: (device.manufacturer -startsWith "Sams")

  • In: usare per i tipi di valore della matrice, ad ["1", "2"]esempio .

    • Valori consentiti: -in | in
    • Esempio: (device.manufacturer -in ["Samsung","Lenovo","Microsoft"])

  • NotIn: usare per i tipi di valore della matrice, ad ["1", "2"]esempio .

    • Valori consentiti: -notIn | notIn
    • Esempio: (device.manufacturer -notIn ["Samsung","Lenovo","Microsoft"])

  • Contiene: usare per i tipi di valore stringa.

    • Valori consentiti: -contains | contains
    • Esempio: (device.manufacturer -contains "Samsung")

  • NotContains: usare per i tipi di valore stringa.

    • Valori consentiti: -notContains | notContains
    • Esempio: (device.manufacturer -notContains "Samsung")

Operatori supportati per operatingSystemVersion

Quando si usa la operatingSystemVersion (Operating System Version) proprietà , è possibile usare gli operatori seguenti nell'editor della sintassi delle regole:

  • Uguale a: usare per tutti i tipi di valore, tra cui regole semplici, stringhe, matrici e altro ancora.

    • Valori consentiti: -eq | eq
    • Esempio: (device.operatingSystemVersion -eq "10.0.22000.1000")

  • NotEquals: usare per tutti i tipi di valore, incluse regole semplici, stringhe, matrici e altro ancora.

    • Valori consentiti: -ne | ne
    • Esempio: (device.operatingSystemVersion -ne "10.0.22000.1000")

  • GreaterThan: usare per i tipi di valore della versione.

    • Valori consentiti: -gt | gt
    • Esempio: (device.operatingSystemVersion -gt 10.0.22000.1000)

  • LessThan: usare per i tipi di valore della versione.

    • Valori consentiti: -lt | lt
    • Esempio: (device.operatingSystemVersion -lt 10.0.22000.1000)

  • GreaterThanOrEquals: usare per i tipi di valore della versione.

    • Valori consentiti: -ge | ge
    • Esempio: (device.operatingSystemVersion -ge 10.0.22000.1000)

  • LessThanOrEquals: usare per i tipi di valore della versione.

    • Valori consentiti: -le | le
    • Esempio: (device.operatingSystemVersion -le 10.0.22000.1000)
  • Last updated on