Propriedades de aplicações e dispositivos, operadores e edição de regras ao criar filtros no Microsoft Intune
Ao criar um aplicativo, uma política de conformidade ou um perfil de configuração, você atribui esse aplicativo ou política a grupos (de usuários ou dispositivos). Quando atribui a aplicação ou a política, também pode utilizar filtros de atribuição.
Pode utilizar filtros em dispositivos geridos (dispositivos inscritos no Intune) e aplicações geridas (aplicações geridas por Intune).
Quando cria um filtro, introduz as propriedades da aplicação ou do dispositivo a utilizar no filtro. Por exemplo:
- No filtro de dispositivo gerido, introduza o fabricante do dispositivo para que a política se aplique apenas aos dispositivos Microsoft.
- No filtro da aplicação gerida, introduza a versão do SO para que a política se aplique apenas a dispositivos com essa versão específica do SO.
A edição avançada de regras também está disponível. Você pode usar operadores comuns, como and
, contains
e startsWith
, para criar expressões. Essas expressões são salvas e usadas no filtro.
Este artigo descreve as diferentes propriedades do dispositivo gerido, as propriedades da aplicação gerida e os operadores que pode utilizar nos filtros e dá exemplos.
Importante
Microsoft Intune está a terminar o suporte para a gestão de administradores de dispositivos Android em dispositivos com acesso ao Google Mobile Services (GMS) a 31 de dezembro de 2024. Após essa data, a inscrição de dispositivos, suporte técnico, correções de erros e correções de segurança estarão indisponíveis. Se utilizar atualmente a gestão de administradores de dispositivos, recomendamos que mude para outra opção de gestão do Android no Intune antes de o suporte terminar. Para obter mais informações, veja Terminar o suporte para administradores de dispositivos Android em dispositivos GMS.
Propriedades do dispositivo gerido
Pode utilizar as seguintes propriedades do dispositivo nas regras de filtro do dispositivo gerido:
cpuArchitecture
(Arquitetura da CPU): crie uma regra de filtro com base na propriedade de arquitetura da CPU do dispositivo Intune.Para o Windows, as suas opções são (com
-eq
,-ne
,-in
,-notIn
operadores):- amd64
- x86
- arm64
- desconhecido
Para macOS, as suas opções são (com
-eq
,-ne
,-in
,-notIn
operadores):- x64
- arm64
- desconhecido
Exemplos:
(device.cpuArchitecture -eq "arm64")
(device.cpuArchitecture -in ["x64", "arm64"])
(device.cpuArchitecture -eq "unknown")
Essa propriedade se aplica a:
- macOS
- Windows 11
- Windows 10
Observação
Atualmente, os cenários de inscrição não suportam a
cpuArchitecture
propriedade . O suporte será adicionado numa atualização futura (sem ETA).deviceCategory
(Categoria do Dispositivo): crie uma regra de filtro com base na propriedade Intune categoria de dispositivo. Insira o valor de cadeia de caracteres completo (usando os operadores-eq
,-ne
,-in
e-notIn
) ou o valor parcial (usando os operadores-startswith
,-contains
e-notcontains
).Exemplos:
(device.deviceCategory -eq "Engineering devices")
(device.deviceCategory -contains "Engineering")
(device.model -startsWith "E")
Essa propriedade se aplica a:
- Administrador de dispositivo Android
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- macOS
- Windows 11
- Windows 10
deviceName
(Nome do Dispositivo): crie uma regra de filtro com base na propriedade Intune nome do dispositivo. Insira um valor de cadeia de caracteres com o nome completo do dispositivo (usando os operadores-eq
,-ne
,-in
e-notIn
) ou um valor parcial (usando os operadores-startswith
,-contains
e-notcontains
).Exemplos:
(device.deviceName -eq "Scott's Device")
(device.deviceName -in ["Scott's device", "Sara's device"])
(device.deviceName -startsWith "S")
Essa propriedade se aplica a:
- Administrador de dispositivo Android
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- macOS
- Windows 11
- Windows 10
deviceOwnership
(Propriedade): crie uma regra de filtro com base na propriedade de propriedade do dispositivo no Intune. SelecionePersonal
,Corporate
ou valores desconhecidos usando os operadores-eq
e-ne
.Exemplo:
(device.deviceOwnership -eq "Personal")
Essa propriedade se aplica a:
- Administrador de dispositivo Android
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- macOS
- Windows 11
- Windows 10
deviceTrustType
(Microsoft Entra tipo de associação): crie uma regra de filtro com base no tipo de associação Microsoft Entra do dispositivo. Escolha entre Azure AD valores associados, Azure AD registados, Associados a Azure AD Híbridos ou Desconhecidos (com-eq
operadores ,-ne
,-in
-notIn
).Exemplos:
(device.deviceTrustType -eq "Azure AD joined")
(device.deviceTrustType -ne "Azure AD registered")
(device.deviceTrustType -in ["Hybrid Azure AD joined","Azure AD joined"])
Essa propriedade se aplica a:
- Windows 11
- Windows 10
Observação
A
deviceTrustType
propriedade existe em Microsoft Entra ID e Intune. Os valores neste artigo Intune filtros aplicam-se a Intune. Não se aplicam a Microsoft Entra ID.enrollmentProfileName
(Nome do perfil de inscrição): crie uma regra de filtro com base no nome do perfil de inscrição. Essa propriedade é aplicada ao dispositivo quando ele é registrado. É um valor de cadeia de caracteres criado por você que corresponde ao perfil de registro do Windows Autopilot, do ADE (Registro de Dispositivo Automatizado) da Apple ou do Google aplicado ao dispositivo. Para ver os nomes dos perfis de inscrição, inicie sessão no centro de administração do Intune e aceda a Dispositivos>Inscrever dispositivos.Insira o valor de cadeia de caracteres completo (usando os operadores
-eq
,-ne
,-in
e-notIn
) ou o valor parcial (usando os operadores-startswith
,-contains
e-notcontains
).Exemplos:
(device.enrollmentProfileName -eq "DEP iPhones")
(device.enrollmentProfileName -startsWith "Autopilot Profile")
(device.enrollmentProfileName -ne $null)
Essa propriedade se aplica a:
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- Windows 11
- Windows 10
IsRooted
(Root ou jailbreak): crie uma regra de filtro com base na propriedade de dispositivo rooting (Android) ou jailbreak (iOS/iPadOS) do dispositivo. SelecioneTrue
,False
ou valores desconhecidos usando os operadores-eq
e-ne
.Exemplo:
(device.isRooted -eq "True")
Essa propriedade se aplica a:
- Administrador de dispositivo Android
- Android Enterprise (somente perfil de trabalho)
- Android (AOSP)
- iOS/iPadOS
manufacturer
(Fabricante): crie uma regra de filtro com base na propriedade Intune fabricante do dispositivo. Insira o valor de cadeia de caracteres completo (usando os operadores-eq
,-ne
,-in
e-notIn
) ou o valor parcial (usando os operadores-startswith
,-contains
e-notcontains
).Exemplos:
(device.manufacturer -eq "Microsoft")
(device.manufacturer -startsWith "Micro")
Essa propriedade se aplica a:
- Administrador de dispositivo Android
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- macOS
- Windows 11
- Windows 10
model
(Modelo): crie uma regra de filtro com base na propriedade Intune modelo de dispositivo. Insira o valor de cadeia de caracteres completo (usando os operadores-eq
,-ne
,-in
e-notIn
) ou o valor parcial (usando os operadores-startswith
,-contains
e-notcontains
).Para dispositivos iOS/iPadOS e macOS, utilize o modelo e não o nome do produto. Apenas o modelo é reconhecido para dispositivos Apple. Por exemplo, para dispositivos iPhone 8, introduza o modelo como
iPhone 8
.Exemplos:
(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")
Essa propriedade se aplica a:
- Administrador de dispositivo Android
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- macOS
- Windows 11
- Windows 10
operatingSystemVersion
(Versão do Sistema Operativo): crie uma regra de filtro com base na versão do sistema operativo (SO) do dispositivo Intune. Introduza um valor de versão (com-eq
os operadores ,-ne
,-gt
,-ge
,-lt
, ).-le
Exemplos:
(device.operatingSystemVersion -eq 14.2.1)
(device.operatingSystemVersion -gt 10.0.22000.1000)
(device.operatingSystemVersion -le 10.0.22631.3235)
Para obter uma lista de operadores suportados, aceda a operatingSystemVersion operadores suportados (neste artigo).
Essa propriedade se aplica a:
- Administrador de dispositivo Android
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- macOS
- Windows 11
- Windows 10
Observação
A
operatingSystemVersion
propriedade está em pré-visualização pública. Para obter mais informações sobre o que isso significa, aceda a Pré-visualização pública no Microsoft Intune.osVersion
(Versão do SO): crie uma regra de filtro com base na versão do sistema operativo (SO) do dispositivo Intune. Insira o valor de cadeia de caracteres completo (usando os operadores-eq
,-ne
,-in
e-notIn
) ou o valor parcial (usando os operadores-startswith
,-contains
e-notcontains
).Dica
A
osVersion
propriedade está a ser preterida. Em vez disso, utilize aoperatingSystemVersion
propriedade . QuandooperatingSystemVersion
estiver disponível geralmente (GA), aosVersion
propriedade será descontinuada e não poderá criar novos filtros com esta propriedade. Os filtros existentes que utilizamosVersion
continuam a funcionar.Exemplos:
(device.osVersion -eq "14.2.1")
(device.osVersion -in ["10.15.3 (19D2064)","10.14.2 (18C54)"])
(device.osVersion -startsWith "10.0.18362")
Essa propriedade se aplica a:
- Administrador de dispositivo Android
- Android Enterprise
- Android (AOSP)
- iOS/iPadOS
- macOS
- Windows 11
- Windows 10
Observação
Para dispositivos Apple, a
OSversion
propriedade não inclui informações SPV (Security Patch Version) da Apple. O SPV é a letra a seguir ao número da versão, como14.1.2a
. Ao criar filtros para dispositivos Apple, não inclua o SPV naOSversion
sintaxe da regra.operatingSystemSKU
(SKU do Sistema Operativo): crie uma regra de filtro com base no SKU do SO do cliente Windows do dispositivo. Insira o valor de cadeia de caracteres completo (usando os operadores-eq
,-ne
,-in
e-notIn
) ou o valor parcial (usando os operadores-startswith
,-contains
e-notcontains
).Exemplos:
(device.operatingSystemSKU -eq "Enterprise")
(device.operatingSystemSKU -in ["Enterprise", "EnterpriseS", "EnterpriseN", "EnterpriseEval"])
(device.operatingSystemSKU -startsWith "Enterprise")
Você pode usar os valores com suporte a seguir para a propriedade SKU do Sistema Operacional. O centro de administração do Intune não mostra os nomes dos SKU. Portanto, use os valores com suporte na seguinte tabela:
Valor compatível Definição do SKU do SO BusinessN Windows 10/11 Professional N (49) CloudEdition CloudEdition (Windows 11 SE (203) CloudEditionN CloudEditionN (Windows 11 SE N (202) Serviços básicos 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) Educação 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) Holográfico 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 para estação de trabalho (161) ProfessionalN Windows 10/11 Professional para estação de trabalho N (162) ProfessionalSingleLanguage Windows 10/11 Professional Single Language (138) ServerRdsh Windows 10/11 Enterprise com várias sessões (175) Essa propriedade se aplica a:
- Windows 11
- Windows 10
Dica
No Windows PowerShell, utilize o Get-WmiObject -Class Win32_OperatingSystem |select operatingsystemSKU
comando num dispositivo Windows para devolver o número do SKU.
Propriedades da aplicação gerida
Pode utilizar as seguintes propriedades da aplicação nas regras de filtro da aplicação gerida:
appVersion
(Versão da Aplicação): crie uma regra de filtro com base na versão da aplicação reportada pelo cliente. Insira o valor de cadeia de caracteres completo (usando os operadores-eq
,-ne
,-in
e-notIn
) ou o valor parcial (usando os operadores-startswith
,-contains
e-notcontains
).Exemplos:
(app.appVersion -eq "14.2.1")
(app.appVersion -in ["10.15.3","10.14.2"])
(app.appVersion -startsWith "10.0")
Essa propriedade se aplica a:
- Android
- iOS/iPadOS
- Windows
deviceManagementType
(Gerenciamento de Dispositivos Type): crie uma regra de filtro com base no tipo de gestão de dispositivos Intune. Selecione a partir dos seguintes valores com os-eq
operadores e-ne
:Valor Plataformas compatíveis 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 Exemplo:
(app.deviceManagementType -eq "Unmanaged")
Esta propriedade aplica-se:
- Android
- iOS/iPadOS
deviceManufacturer
(Fabricante): crie uma regra de filtro com base no fabricante do dispositivo reportado pelo cliente. Insira o valor de cadeia de caracteres completo (usando os operadores-eq
,-ne
,-in
e-notIn
) ou o valor parcial (usando os operadores-startswith
,-contains
e-notcontains
).Exemplos:
(app.deviceManufacturer -eq "Microsoft")
(app.deviceManufacturer -startsWith "Micro")
Esta propriedade aplica-se:
- Android
- iOS/iPadOS
- Windows
deviceModel
(Modelo): crie uma regra de filtro com base no modelo de dispositivo reportado pelo cliente. Insira o valor de cadeia de caracteres completo (usando os operadores-eq
,-ne
,-in
e-notIn
) ou o valor parcial (usando os operadores-startswith
,-contains
e-notcontains
).Exemplos:
(app.deviceModel -eq "Surface Duo")
(app.deviceModel -in ["Surface Duo", "Surface Duo 2"])
(app.deviceModel -startsWith "Surface Duo")
(app.deviceModel -startsWith "RealityDevice")
Essa propriedade se aplica a:
- Android
- iOS/iPadOS/visionOS
- Windows
Observação
A
app.deviceModel -startsWith "RealityDevice"
propriedade está em pré-visualização e só é suportada na aplicação Microsoft Teams. Se a sua política de proteção de aplicações for direcionada para a plataforma iOS/iPadOS, também se aplicará ao visionOS. No entanto, ao filtrar definições de iniciação condicional específicas para visionOS, como "Versão mínima/Máx. do SO" ou "Versão mínima da aplicação", pode utilizar a propriedadeapp.deviceModel -startsWith "RealityDevice"
da aplicação nas regras de filtro da aplicação gerida.operatingSystemVersion
(Versão do Sistema Operativo): crie uma regra de filtro com base na versão do sistema operativo (SO) do dispositivo Intune. Introduza um valor de versão (com-eq
os operadores ,-ne
,-gt
,-ge
,-lt
, ).-le
Exemplos:
(app.operatingSystemVersion -eq 14.2.1)
(app.operatingSystemVersion -gt 10.0.22000.1000)
(app.operatingSystemVersion -le 10.0.22631.3235)
Para obter uma lista de operadores suportados, aceda a operatingSystemVersion operadores suportados (neste artigo).
Essa propriedade se aplica a:
- Android
- iOS/iPadOS
- Windows
Observação
A
operatingSystemVersion
propriedade está em pré-visualização pública. Para obter mais informações sobre o que isso significa, aceda a Pré-visualização pública no Microsoft Intune.osVersion
(Versão do SO): crie uma regra de filtro com base na versão do sistema operativo (SO) comunicada pelo cliente. Insira o valor de cadeia de caracteres completo (usando os operadores-eq
,-ne
,-in
e-notIn
) ou o valor parcial (usando os operadores-startswith
,-contains
e-notcontains
).Dica
A
osVersion
propriedade está a ser preterida. Em vez disso, utilize aoperatingSystemVersion
propriedade . QuandooperatingSystemVersion
estiver disponível geralmente (GA), aosVersion
propriedade será descontinuada e não poderá criar novos filtros com esta propriedade. Os filtros existentes que utilizamosVersion
continuam a funcionar.Exemplos:
(app.osVersion -eq "14.2.1")
(app.osVersion -in ["10.15.3","10.14.2"])
(app.osVersion -startsWith "10.0")
Essa propriedade se aplica a:
- Android
- iOS/iPadOS
- Windows
Edição avançada de regra
Ao criar um filtro, você pode criar manualmente regras simples ou complexas no editor de sintaxe da regra. Você também pode usar operadores comuns, como or
, contains
e muitos outros. O formato é semelhante a Microsoft Entra grupos dinâmicos: ([entity].[property name] [operation] [value])
.
O que você precisa saber
As propriedades, as operações e os valores não diferenciam maiúsculas de minúsculas.
Há suporte para parênteses e parênteses aninhados.
Pode utilizar
Null
ou$Null
como um valor com os-Equals
operadores e-NotEquals
.Algumas opções avançadas de sintaxe, como parênteses aninhados, só estão disponíveis no editor de sintaxe da regra. Se você usar expressões avançadas no editor de sintaxe da regra, o construtor de regras será desabilitado.
Para obter mais informações sobre o editor de sintaxe de regras e o construtor de regras, aceda a Utilizar filtros ao atribuir as suas aplicações, políticas e perfis
Operadores com suporte
Você pode usar os seguintes operadores no editor de sintaxe da regra:
Or: use para todos os tipos de valor, principalmente ao agrupar regras simples.
-
Valores permitidos:
-or
|or
-
Exemplo:
(device.manufacturer -eq "Samsung") or (device.model -contains "Galaxy Note")
-
Valores permitidos:
And: use para todos os tipos de valor, principalmente ao agrupar regras simples.
-
Valores permitidos:
-and
|and
-
Exemplo:
(device.manufacturer -eq "Samsung") and (device.model -contains "Galaxy Note")
-
Valores permitidos:
Equals: use para todos os tipos de valor, incluindo regras simples, cadeias de caracteres, matrizes e muito mais.
-
Valores permitidos:
-eq
|eq
-
Exemplo:
(device.manufacturer -eq "Samsung") and (device.model -eq "Galaxy Note")
-
Valores permitidos:
NotEquals: use para todos os tipos de valor, incluindo regras simples, cadeias de caracteres, matrizes e muito mais.
-
Valores permitidos:
-ne
|ne
-
Exemplo:
(device.manufacturer -ne "Samsung") or (device.model -ne "Galaxy Note")
-
Valores permitidos:
StartsWith: use para tipos de valor de cadeia de caracteres.
-
Valores permitidos:
-startsWith
|startsWith
-
Exemplo:
(device.manufacturer -startsWith "Sams")
-
Valores permitidos:
In: use para tipos de valor de matriz, como
["1", "2"]
.-
Valores permitidos:
-in
|in
-
Exemplo:
(device.manufacturer -in ["Samsung","Lenovo","Microsoft"])
-
Valores permitidos:
NotIn: use para tipos de valor de matriz, como
["1", "2"]
.-
Valores permitidos:
-notIn
|notIn
-
Exemplo:
(device.manufacturer -notIn ["Samsung","Lenovo","Microsoft"])
-
Valores permitidos:
Contains: use para tipos de valor de cadeia de caracteres.
-
Valores permitidos:
-contains
|contains
-
Exemplo:
(device.manufacturer -contains "Samsung")
-
Valores permitidos:
NotContains: use para tipos de valor de cadeia de caracteres.
-
Valores permitidos:
-notContains
|notContains
-
Exemplo:
(device.manufacturer -notContains "Samsung")
-
Valores permitidos:
operadores suportados operatingSystemVersion
Quando utiliza a operatingSystemVersion (Operating System Version)
propriedade , pode utilizar os seguintes operadores no editor de sintaxe de regras:
Equals: use para todos os tipos de valor, incluindo regras simples, cadeias de caracteres, matrizes e muito mais.
-
Valores permitidos:
-eq
|eq
-
Exemplo:
(device.operatingSystemVersion -eq "10.0.22000.1000")
-
Valores permitidos:
NotEquals: use para todos os tipos de valor, incluindo regras simples, cadeias de caracteres, matrizes e muito mais.
-
Valores permitidos:
-ne
|ne
-
Exemplo:
(device.operatingSystemVersion -ne "10.0.22000.1000")
-
Valores permitidos:
GreaterThan: utilize para tipos de valor de versão.
-
Valores permitidos:
-gt
|gt
-
Exemplo:
(device.operatingSystemVersion -gt 10.0.22000.1000)
-
Valores permitidos:
LessThan: utilize para tipos de valor de versão.
-
Valores permitidos:
-lt
|lt
-
Exemplo:
(device.operatingSystemVersion -lt 10.0.22000.1000)
-
Valores permitidos:
GreaterThanOrEquals: utilize para tipos de valor de versão.
-
Valores permitidos:
-ge
|ge
-
Exemplo:
(device.operatingSystemVersion -ge 10.0.22000.1000)
-
Valores permitidos:
LessThanOrEquals: utilize para tipos de valor de versão.
-
Valores permitidos:
-le
|le
-
Exemplo:
(device.operatingSystemVersion -le 10.0.22000.1000)
-
Valores permitidos: