Trabalhando com o Intune no Microsoft GraphWorking with Intune in Microsoft Graph  

Importante

APIs na /beta versão no Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported. Para determinar se uma API está disponível em v1.0, use o seletor De versão.To determine whether an API is available in v1.0, use the Version selector.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

A API do Microsoft Graph para Intune permite o acesso programático a informações do Intune para seu locatário; a API executa as mesmas operações do Intune disponíveis pelo Portal do Azure.The Microsoft Graph API for Intune enables programmatic access to Intune information for your tenant; the API performs the same Intune operations as those available through the Azure Portal.  

Em cenários de gerenciamento de dispositivo móvel (MDM), a API do Microsoft Graph para Intune oferece suporte a implantações autônomas; não há suporte paraimplantações híbridas do Intune.For mobile device management (MDM) scenarios, the Microsoft Graph API for Intune supports standalone deployments; Intune hybrid deployments are not supported.

Todas as APIs do Microsoft Graph beta para o Intune são testadas e validadas pela equipe do Intune antes de serem implantadas.All Microsoft Graph beta APIs for Intune are tested and validated by the Intune team before they're deployed. Para as últimas mudanças nas APIs, consulte o changelog.For the latest API changes, see the changelog.

Uso da API do Microsoft Graph no IntuneUsing the Microsoft Graph API for Intune

O Intune fornece dados para o Microsoft Graph da mesma forma que outros serviços em nuvem, com rica informação de entidade e navegação de relacionamento.Intune provides data into Microsoft Graph in the same way that other cloud services do, with rich entity information and relationship navigation.Use o Microsoft Graph para combinar informações de outros serviços e do Intune e criar aplicativos avançados com serviços variados para profissionais de TI ou usuários finais. Use Microsoft Graph to combine information from other services and Intune to build rich cross-service applications for IT professionals or end users.     

O exemplo a seguir mostra como determinar se um aplicativo está instalado no dispositivo de um usuário:The following example shows how you can determine whether an application is installed on a user's device: 

  1. Obtenha no Azure Active Directory uma lista dos dispositivos registrados de um usuário:Get from Azure Active Directory a list of devices registered to a user: 

    https://graph.microsoft.com/beta/users/{user}/ownedDevices 

  2. Em seguida, exiba a lista de aplicativos do seu locatário:Then view the list of applications for your tenant: 

    https://graph.microsoft.com/beta/deviceAppManagement/mobileApps  

  3. Obtenha a ID do aplicativo e determine o estado de instalação do aplicativo (e, portanto, do usuário):Take the ID from the application and determine the installation state for the application (and therefore user):

    https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{id}/deviceStatuses/

Uso das permissões do Microsoft GraphUsing Microsoft Graph permissions

O Microsoft Graph controla o acesso aos recursos por meio de permissões.Microsoft Graph controls access to resources via permissions. Como desenvolvedor, você deve especificar as permissões necessárias para acessar os recursos do Intune.As a developer, you must specify the permissions you need to access Intune resources. Normalmente, você deve especificar as permissões no portal do Azure Active Directory.Typically, you specify the permissions in the Azure Active Directory portal. Para saber mais, confira Referência de permissões do Microsoft Graph.For more information, see Microsoft Graph permissions reference.

NovidadesWhat's new

Saiba mais sobre os novos recursos e atualizações mais recentes para este conjunto de APIs.Find out about the latest new features and updates for this API set.

Próximas etapasNext Steps