Partilhar via

Propriedades de aplicações e dispositivos, operadores e edição de regras ao criar filtros no Microsoft Intune

  • Artigo

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 pelo 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

O Microsoft Intune vai 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 arquitetura da CPU de dispositivos do 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 categoria de dispositivo do 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).

    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 Nome do dispositivo do Intune. 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. Selecione Personal, 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 (Tipo de associação microsoft Entra): crie uma regra de filtro com base no tipo de associação Microsoft Entra do dispositivo. Escolha entre valores associados ao Azure AD, registados no Azure Active Directory, associados ao Azure AD Híbrido ou Valores desconhecidos (com -eq, -ne, -in, -notIn operadores).

    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 no Microsoft Entra ID e no Intune. Os valores neste artigo de filtros do Intune aplicam-se ao Intune. Não se aplicam ao ID do Microsoft Entra.

  • 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. Selecione True, 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 fabricante do dispositivo do 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).

    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 do modelo de dispositivo do 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).

    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 de dispositivos (SO) do Intune. Introduza um valor de versão (com -eqos 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 de dispositivos (SO) do 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 a operatingSystemVersion propriedade . Quando operatingSystemVersion estiver disponível geralmente (GA), a osVersion propriedade será descontinuada e não poderá criar novos filtros com esta propriedade. Os filtros existentes que utilizam osVersion 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, como 14.1.2a. Ao criar filtros para dispositivos Apple, não inclua o SPV na OSversion 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 (Tipo de Gestão de Dispositivos): crie uma regra de filtro com base no tipo de gestão de dispositivos do Intune. Selecione a partir dos seguintes valores com os -eq operadores e -ne :

    Valor Plataformas compatíveis
    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

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

    Essa propriedade se aplica a:

    • Android
    • iOS/iPadOS
    • Windows

  • operatingSystemVersion (Versão do Sistema Operativo): crie uma regra de filtro com base na versão do sistema operativo de dispositivos (SO) do Intune. Introduza um valor de versão (com -eqos 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 a operatingSystemVersion propriedade . Quando operatingSystemVersion estiver disponível geralmente (GA), a osVersion propriedade será descontinuada e não poderá criar novos filtros com esta propriedade. Os filtros existentes que utilizam osVersion 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 aos grupos dinâmicos do Microsoft Entra: ([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")

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

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

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

  • StartsWith: use para tipos de valor de cadeia de caracteres.

    • Valores permitidos: -startsWith | startsWith
    • Exemplo: (device.manufacturer -startsWith "Sams")

  • In: use para tipos de valor de matriz, como ["1", "2"].

    • Valores permitidos: -in | in
    • Exemplo: (device.manufacturer -in ["Samsung","Lenovo","Microsoft"])

  • NotIn: use para tipos de valor de matriz, como ["1", "2"].

    • Valores permitidos: -notIn | notIn
    • Exemplo: (device.manufacturer -notIn ["Samsung","Lenovo","Microsoft"])

  • Contains: use para tipos de valor de cadeia de caracteres.

    • Valores permitidos: -contains | contains
    • Exemplo: (device.manufacturer -contains "Samsung")

  • NotContains: use para tipos de valor de cadeia de caracteres.

    • Valores permitidos: -notContains | notContains
    • Exemplo: (device.manufacturer -notContains "Samsung")

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

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

  • GreaterThan: utilize para tipos de valor de versão.

    • Valores permitidos: -gt | gt
    • Exemplo: (device.operatingSystemVersion -gt 10.0.22000.1000)

  • LessThan: utilize para tipos de valor de versão.

    • Valores permitidos: -lt | lt
    • Exemplo: (device.operatingSystemVersion -lt 10.0.22000.1000)

  • GreaterThanOrEquals: utilize para tipos de valor de versão.

    • Valores permitidos: -ge | ge
    • Exemplo: (device.operatingSystemVersion -ge 10.0.22000.1000)

  • LessThanOrEquals: utilize para tipos de valor de versão.

    • Valores permitidos: -le | le
    • Exemplo: (device.operatingSystemVersion -le 10.0.22000.1000)