Propiedades, operadores y edición de reglas de aplicaciones y dispositivos al crear filtros en Microsoft Intune
Al crear una aplicación, una directiva de cumplimiento o un perfil de configuración, se asigna esa aplicación o directiva a grupos (usuarios o dispositivos). Al asignar la aplicación o la directiva, también puede usar filtros de asignación.
Puede usar filtros en dispositivos administrados (dispositivos inscritos en Intune) y aplicaciones administradas (aplicaciones administradas por Intune).
Cuando se crea un filtro, se escriben las propiedades de aplicación o dispositivo que se van a usar en el filtro. Por ejemplo:
- En el filtro de dispositivo administrado, escriba el fabricante del dispositivo para que la directiva solo se aplique a los dispositivos de Microsoft.
- En el filtro de aplicación administrada, escriba la versión del sistema operativo para que la directiva solo se aplique a los dispositivos con esa versión específica del sistema operativo.
También está disponible la edición avanzada de reglas. Para crear expresiones, se pueden usar operadores comunes, como and
, contains
y startsWith
. Estas expresiones se guardan y se usan en el filtro.
En este artículo se describen las distintas propiedades de dispositivo administrado, las propiedades de la aplicación administrada y los operadores que puede usar en los filtros y se proporcionan ejemplos.
Importante
Microsoft Intune está finalizando la compatibilidad con la administración del administrador de dispositivos Android en dispositivos con acceso a Google Mobile Services (GMS) el 31 de diciembre de 2024. Después de esa fecha, la inscripción de dispositivos, el soporte técnico, las correcciones de errores y las correcciones de seguridad no estarán disponibles. Si actualmente usa la administración del administrador de dispositivos, se recomienda cambiar a otra opción de administración de Android en Intune antes de que finalice el soporte técnico. Para obtener más información, consulte Finalización de la compatibilidad con el administrador de dispositivos Android en dispositivos GMS.
Propiedades del dispositivo administrado
Puede usar las siguientes propiedades de dispositivo en las reglas de filtro de dispositivos administrados:
cpuArchitecture
(Arquitectura de CPU): cree una regla de filtro basada en la propiedad de arquitectura de CPU del dispositivo intune.Para Windows, las opciones son (con
-eq
operadores ,-ne
,-in
,-notIn
):- amd64
- x86
- arm64
- desconocido
Para macOS, las opciones son (con
-eq
operadores ,-ne
,-in
,-notIn
):- x64
- arm64
- desconocido
Ejemplos:
(device.cpuArchitecture -eq "arm64")
(device.cpuArchitecture -in ["x64", "arm64"])
(device.cpuArchitecture -eq "unknown")
Esta propiedad se aplica a:
- macOS
- Windows 11
- Windows 10
Nota:
Actualmente, los escenarios de inscripción no admiten la
cpuArchitecture
propiedad . La compatibilidad se agregará en una actualización futura (sin ETA).deviceCategory
(Categoría de dispositivo): cree una regla de filtro basada en la propiedad de categoría de dispositivo de Intune. Escriba el valor de cadena completo (mediante los operadores-eq
,-ne
,-in
y-notIn
) o un valor parcial (mediante los operadores-startswith
,-contains
y-notcontains
).Ejemplos:
(device.deviceCategory -eq "Engineering devices")
(device.deviceCategory -contains "Engineering")
(device.model -startsWith "E")
Esta propiedad se aplica a:
- Administrador de dispositivos Android
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- macOS
- Windows 11
- Windows 10
deviceName
(Nombre del dispositivo): cree una regla de filtro basada en la propiedad de nombre de dispositivo de Intune. Escriba un valor de cadena para el nombre completo del dispositivo (mediante los operadores-eq
,-ne
,-in
y-notIn
) o un valor parcial (mediante los operadores-startswith
,-contains
y-notcontains
).Ejemplos:
(device.deviceName -eq "Scott's Device")
(device.deviceName -in ["Scott's device", "Sara's device"])
(device.deviceName -startsWith "S")
Esta propiedad se aplica a:
- Administrador de dispositivos Android
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- macOS
- Windows 11
- Windows 10
deviceOwnership
(Propiedad): cree una regla de filtro basada en la propiedad de propiedad del dispositivo en Intune. SeleccionePersonal
,Corporate
o valores desconocidos mediante los operadores-eq
y-ne
.Ejemplo:
(device.deviceOwnership -eq "Personal")
Esta propiedad se aplica a:
- Administrador de dispositivos Android
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- macOS
- Windows 11
- Windows 10
deviceTrustType
(Tipo de combinación de Microsoft Entra): cree una regla de filtro basada en el tipo de combinación Microsoft Entra del dispositivo. Elija entre valores unidos a Azure AD, registrados en Azure AD, Unidos a Azure AD híbrido o Valores desconocidos (con-eq
operadores ,-ne
,-in
-notIn
).Ejemplos:
(device.deviceTrustType -eq "Azure AD joined")
(device.deviceTrustType -ne "Azure AD registered")
(device.deviceTrustType -in ["Hybrid Azure AD joined","Azure AD joined"])
Esta propiedad se aplica a:
- Windows 11
- Windows 10
Nota:
La
deviceTrustType
propiedad existe en Microsoft Entra ID e Intune. Los valores de este artículo de filtros de Intune se aplican a Intune. No se aplican a Microsoft Entra ID.enrollmentProfileName
(Nombre del perfil de inscripción): cree una regla de filtro basada en el nombre del perfil de inscripción. Esta propiedad se aplica a un dispositivo cuando este se inscribe. Es un valor de cadena creado por el usuario y coincide con el Windows Autopilot, la inscripción automatizada de dispositivos (ADE) de Apple o el perfil de inscripción de Google aplicado al dispositivo. Para ver los nombres de perfil de inscripción, inicie sesión en el Centro de administración de Intune y vaya a Dispositivos>inscribir dispositivos.Escriba el valor de cadena completo (mediante los operadores
-eq
,-ne
,-in
y-notIn
) o un valor parcial (mediante los operadores-startswith
,-contains
y-notcontains
).Ejemplos:
(device.enrollmentProfileName -eq "DEP iPhones")
(device.enrollmentProfileName -startsWith "Autopilot Profile")
(device.enrollmentProfileName -ne $null)
Esta propiedad se aplica a:
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- Windows 11
- Windows 10
IsRooted
(Rooteado o jailbreak): cree una regla de filtro basada en la propiedad del dispositivo rooteado (Android) o jailbreak (iOS/iPadOS). SeleccioneTrue
,False
o valores desconocidos mediante los operadores-eq
y-ne
.Ejemplo:
(device.isRooted -eq "True")
Esta propiedad se aplica a:
- Administrador de dispositivos Android
- Android Enterprise (solo perfil de trabajo)
- Android (AOSP)
- iOS/iPadOS
manufacturer
(Fabricante): cree una regla de filtro basada en la propiedad de fabricante del dispositivo de Intune. Escriba el valor de cadena completo (mediante los operadores-eq
,-ne
,-in
y-notIn
) o un valor parcial (mediante los operadores-startswith
,-contains
y-notcontains
).Ejemplos:
(device.manufacturer -eq "Microsoft")
(device.manufacturer -startsWith "Micro")
Esta propiedad se aplica a:
- Administrador de dispositivos Android
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- macOS
- Windows 11
- Windows 10
model
(Modelo): cree una regla de filtro basada en la propiedad del modelo de dispositivo de Intune. Escriba el valor de cadena completo (mediante los operadores-eq
,-ne
,-in
y-notIn
) o un valor parcial (mediante los operadores-startswith
,-contains
y-notcontains
).Para dispositivos iOS/iPadOS y macOS, use el modelo, no el nombre del producto. Solo se reconoce el modelo para dispositivos Apple. Por ejemplo, para dispositivos iPhone 8, escriba el modelo como
iPhone 8
.Ejemplos:
(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")
Esta propiedad se aplica a:
- Administrador de dispositivos Android
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- macOS
- Windows 11
- Windows 10
operatingSystemVersion
(Versión del sistema operativo): cree una regla de filtro basada en la versión del sistema operativo (SO) de dispositivo de Intune. Escriba un valor de versión (con-eq
operadores ,-ne
,-gt
,-ge
,-lt
).-le
Ejemplos:
(device.operatingSystemVersion -eq 14.2.1)
(device.operatingSystemVersion -gt 10.0.22000.1000)
(device.operatingSystemVersion -le 10.0.22631.3235)
Para obtener una lista de los operadores admitidos, vaya a operadores compatibles con operatingSystemVersion (en este artículo).
Esta propiedad se aplica a:
- Administrador de dispositivos Android
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- macOS
- Windows 11
- Windows 10
Nota:
La
operatingSystemVersion
propiedad está en versión preliminar pública. Para obtener más información sobre lo que significa, vaya a Versión preliminar pública en Microsoft Intune.osVersion
(Versión del sistema operativo): cree una regla de filtro basada en la versión del sistema operativo de dispositivo (SO) de Intune. Escriba el valor de cadena completo (mediante los operadores-eq
,-ne
,-in
y-notIn
) o un valor parcial (mediante los operadores-startswith
,-contains
y-notcontains
).Sugerencia
La
osVersion
propiedad está en desuso. En su lugar, use laoperatingSystemVersion
propiedad . CuandooperatingSystemVersion
esté disponible con carácter general (GA), laosVersion
propiedad se retirará y no podrá crear nuevos filtros mediante esta propiedad. Los filtros existentes que usanosVersion
siguen funcionando.Ejemplos:
(device.osVersion -eq "14.2.1")
(device.osVersion -in ["10.15.3 (19D2064)","10.14.2 (18C54)"])
(device.osVersion -startsWith "10.0.18362")
Esta propiedad se aplica a:
- Administrador de dispositivos Android
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- macOS
- Windows 11
- Windows 10
Nota:
En el caso de los dispositivos Apple, la
OSversion
propiedad no incluye información de la versión de revisión de seguridad (SPV) de Apple. El SPV es la letra después del número de versión, como14.1.2a
. Al crear filtros para dispositivos Apple, no incluya el SPV en la sintaxis de reglaOSversion
.operatingSystemSKU
(SKU del sistema operativo): cree una regla de filtro basada en la SKU del sistema operativo cliente Windows del dispositivo. Escriba el valor de cadena completo (mediante los operadores-eq
,-ne
,-in
y-notIn
) o un valor parcial (mediante los operadores-startswith
,-contains
y-notcontains
).Ejemplos:
(device.operatingSystemSKU -eq "Enterprise")
(device.operatingSystemSKU -in ["Enterprise", "EnterpriseS", "EnterpriseN", "EnterpriseEval"])
(device.operatingSystemSKU -startsWith "Enterprise")
Puede usar los siguientes valores admitidos para la propiedad SKU del sistema operativo. El Centro de administración de Intune no muestra los nombres de SKU. Por lo tanto, asegúrese de usar los valores admitidos en la tabla siguiente:
Valor admitido Definición de SKU del sistema operativo BusinessN Windows 10/11 Professional N (49) CloudEdition CloudEdition (Windows 11 SE (203) CloudEditionN CloudEditionN (Windows 11 SE N (202) Incorporación principal 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) Educación Windows 10/11 Education (121) EducationN Windows 10/11 Education (122) Empresarial 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 Windows 10/11 Enterprise N Evaluation (84) EnterpriseS Windows 10 Enterprise LTSC (125) EnterpriseSEval Windows 10 Enterprise LTSC Evaluation (129) EnterpriseSN Windows 10 Enterprise LTSC N (126) Holographic 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 for workstation (161) ProfessionalN Windows 10/11 Professional for workstation N (162) ProfessionalSingleLanguage Windows 10/11 Professional Single Language (138) ServerRdsh Windows 10/11 Enterprise multi-session (175) Esta propiedad se aplica a:
- Windows 11
- Windows 10
Sugerencia
En Windows PowerShell, use el Get-WmiObject -Class Win32_OperatingSystem |select operatingsystemSKU
comando en un dispositivo Windows para devolver el número de SKU.
Propiedades de la aplicación administrada
Puede usar las siguientes propiedades de aplicación en las reglas de filtro de aplicaciones administradas:
appVersion
(Versión de la aplicación): cree una regla de filtro basada en la versión de la aplicación notificada por el cliente. Escriba el valor de cadena completo (mediante los operadores-eq
,-ne
,-in
y-notIn
) o un valor parcial (mediante los operadores-startswith
,-contains
y-notcontains
).Ejemplos:
(app.appVersion -eq "14.2.1")
(app.appVersion -in ["10.15.3","10.14.2"])
(app.appVersion -startsWith "10.0")
Esta propiedad se aplica a:
- Android
- iOS/iPadOS
- Windows
deviceManagementType
(Tipo de administración de dispositivos): cree una regla de filtro basada en el tipo de administración de dispositivos de Intune. Seleccione entre los siguientes valores mediante los-eq
operadores y-ne
:Valor Plataformas compatibles 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 Ejemplo:
(app.deviceManagementType -eq "Unmanaged")
Esta propiedad se aplica a:
- Android
- iOS/iPadOS
deviceManufacturer
(Fabricante): cree una regla de filtro basada en el fabricante del dispositivo notificado por el cliente. Escriba el valor de cadena completo (mediante los operadores-eq
,-ne
,-in
y-notIn
) o un valor parcial (mediante los operadores-startswith
,-contains
y-notcontains
).Ejemplos:
(app.deviceManufacturer -eq "Microsoft")
(app.deviceManufacturer -startsWith "Micro")
Esta propiedad se aplica a:
- Android
- iOS/iPadOS
- Windows
deviceModel
(Modelo): cree una regla de filtro basada en el modelo de dispositivo notificado por el cliente. Escriba el valor de cadena completo (mediante los operadores-eq
,-ne
,-in
y-notIn
) o un valor parcial (mediante los operadores-startswith
,-contains
y-notcontains
).Ejemplos:
(app.deviceModel -eq "Surface Duo")
(app.deviceModel -in ["Surface Duo", "Surface Duo 2"])
(app.deviceModel -startsWith "Surface Duo")
Esta propiedad se aplica a:
- Android
- iOS/iPadOS
- Windows
operatingSystemVersion
(Versión del sistema operativo): cree una regla de filtro basada en la versión del sistema operativo (SO) de dispositivo de Intune. Escriba un valor de versión (con-eq
operadores ,-ne
,-gt
,-ge
,-lt
).-le
Ejemplos:
(app.operatingSystemVersion -eq 14.2.1)
(app.operatingSystemVersion -gt 10.0.22000.1000)
(app.operatingSystemVersion -le 10.0.22631.3235)
Para obtener una lista de los operadores admitidos, vaya a operadores compatibles con operatingSystemVersion (en este artículo).
Esta propiedad se aplica a:
- Android
- iOS/iPadOS
- Windows
Nota:
La
operatingSystemVersion
propiedad está en versión preliminar pública. Para obtener más información sobre lo que significa, vaya a Versión preliminar pública en Microsoft Intune.osVersion
(Versión del sistema operativo): cree una regla de filtro basada en la versión del sistema operativo (SO) notificada por el cliente. Escriba el valor de cadena completo (mediante los operadores-eq
,-ne
,-in
y-notIn
) o un valor parcial (mediante los operadores-startswith
,-contains
y-notcontains
).Sugerencia
La
osVersion
propiedad está en desuso. En su lugar, use laoperatingSystemVersion
propiedad . CuandooperatingSystemVersion
esté disponible con carácter general (GA), laosVersion
propiedad se retirará y no podrá crear nuevos filtros mediante esta propiedad. Los filtros existentes que usanosVersion
siguen funcionando.Ejemplos:
(app.osVersion -eq "14.2.1")
(app.osVersion -in ["10.15.3","10.14.2"])
(app.osVersion -startsWith "10.0")
Esta propiedad se aplica a:
- Android
- iOS/iPadOS
- Windows
Edición avanzada de reglas
Al crear un filtro, puede crear manualmente reglas simples o complejas en el editor de sintaxis de reglas. También puede usar operadores comunes, como or
, contains
, etc. El formato es similar a los grupos dinámicos de Microsoft Entra: ([entity].[property name] [operation] [value])
.
Aspectos que debe saber
Las propiedades, las operaciones y los valores no distinguen mayúsculas de minúsculas.
Se admiten paréntesis y paréntesis anidados.
Puede usar
Null
o$Null
como un valor con los-Equals
operadores y-NotEquals
.Algunas opciones de sintaxis avanzadas, como paréntesis anidados, solo están disponibles en el editor de sintaxis de reglas. Si usa expresiones avanzadas en el editor de sintaxis de reglas, el generador de reglas se deshabilita.
Para obtener más información sobre el editor de sintaxis de reglas y el generador de reglas, vaya a Usar filtros al asignar aplicaciones, directivas y perfiles.
Operadores admitidos
Puede usar los operadores siguientes en el editor de sintaxis de reglas:
Or: se usa para todos los tipos de valor, especialmente al agrupar reglas simples.
-
Valores permitidos:
-or
|or
-
Ejemplo:
(device.manufacturer -eq "Samsung") or (device.model -contains "Galaxy Note")
-
Valores permitidos:
And: se usa para todos los tipos de valor, especialmente al agrupar reglas simples.
-
Valores permitidos:
-and
|and
-
Ejemplo:
(device.manufacturer -eq "Samsung") and (device.model -contains "Galaxy Note")
-
Valores permitidos:
Equals: se usa para todos los tipos de valor, incluidas reglas simples, cadenas, matrices, etc.
-
Valores permitidos:
-eq
|eq
-
Ejemplo:
(device.manufacturer -eq "Samsung") and (device.model -eq "Galaxy Note")
-
Valores permitidos:
NotEquals: se usa para todos los tipos de valor, incluidas reglas simples, cadenas, matrices, etc.
-
Valores permitidos:
-ne
|ne
-
Ejemplo:
(device.manufacturer -ne "Samsung") or (device.model -ne "Galaxy Note")
-
Valores permitidos:
StartsWith: se usa para tipos de valor de cadena.
-
Valores permitidos:
-startsWith
|startsWith
-
Ejemplo:
(device.manufacturer -startsWith "Sams")
-
Valores permitidos:
In: se usa para tipos de valor de matriz, como
["1", "2"]
.-
Valores permitidos:
-in
|in
-
Ejemplo:
(device.manufacturer -in ["Samsung","Lenovo","Microsoft"])
-
Valores permitidos:
NotIn: se usa para tipos de valor de matriz, como
["1", "2"]
.-
Valores permitidos:
-notIn
|notIn
-
Ejemplo:
(device.manufacturer -notIn ["Samsung","Lenovo","Microsoft"])
-
Valores permitidos:
Contains: se usa para tipos de valor de cadena.
-
Valores permitidos:
-contains
|contains
-
Ejemplo:
(device.manufacturer -contains "Samsung")
-
Valores permitidos:
NotContains: se usa para tipos de valor de cadena.
-
Valores permitidos:
-notContains
|notContains
-
Ejemplo:
(device.manufacturer -notContains "Samsung")
-
Valores permitidos:
operadores compatibles con operatingSystemVersion
Al usar la operatingSystemVersion (Operating System Version)
propiedad , puede usar los siguientes operadores en el editor de sintaxis de regla:
Equals: se usa para todos los tipos de valor, incluidas reglas simples, cadenas, matrices, etc.
-
Valores permitidos:
-eq
|eq
-
Ejemplo:
(device.operatingSystemVersion -eq "10.0.22000.1000")
-
Valores permitidos:
NotEquals: se usa para todos los tipos de valor, incluidas reglas simples, cadenas, matrices, etc.
-
Valores permitidos:
-ne
|ne
-
Ejemplo:
(device.operatingSystemVersion -ne "10.0.22000.1000")
-
Valores permitidos:
GreaterThan: se usa para los tipos de valor de versión.
-
Valores permitidos:
-gt
|gt
-
Ejemplo:
(device.operatingSystemVersion -gt 10.0.22000.1000)
-
Valores permitidos:
LessThan: se usa para los tipos de valor de versión.
-
Valores permitidos:
-lt
|lt
-
Ejemplo:
(device.operatingSystemVersion -lt 10.0.22000.1000)
-
Valores permitidos:
GreaterThanOrEquals: se usa para los tipos de valor de versión.
-
Valores permitidos:
-ge
|ge
-
Ejemplo:
(device.operatingSystemVersion -ge 10.0.22000.1000)
-
Valores permitidos:
LessThanOrEquals: se usa para los tipos de valor de versión.
-
Valores permitidos:
-le
|le
-
Ejemplo:
(device.operatingSystemVersion -le 10.0.22000.1000)
-
Valores permitidos: