Partilhar via

Relatórios do Export Intune que utilizam APIs Graph

  • Artigo

Todos os relatórios que tenham sido migrados para a infraestrutura de informação intune estarão disponíveis para exportação a partir de uma única API de exportação de alto nível. Tem de utilizar a API microsoft Graph para es fazer a chamada HTTP. O Microsoft Graph é uma API web RESTful que lhe permite aceder aos recursos do serviço Microsoft Cloud.

Nota

Para obter informações sobre a realização de chamadas de API REST, incluindo ferramentas para interagir com a Microsoft Graph, consulte utilizar a API Graph microsoft.

Microsoft Endpoint Manager exportará relatórios utilizando o seguinte ponto final da Microsoft Graph API:

https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs

Exemplo dispositivos reportam pedido e resposta

Ao entear o pedido, deve fornecer um reportName parâmetro como parte do organismo de pedido com base no relatório que pretende exportar. Segue-se um exemplo de um pedido de exportação para o relatório dispositivos. Tem de utilizar o método POST HTTP a seu pedido. O método POST é utilizado para criar um novo recurso ou realizar uma ação.

Exemplo de pedido

O pedido abaixo contém o método HTTP utilizado no pedido à Microsoft Graph.

{ 
    "reportName": "Devices", 
    "filter":"(OwnerType eq '1')", 
    "localizationType": "LocalizedValuesAsAdditionalColumn", 
    "select": [ 
        "DeviceName", 
        "managementAgent", 
        "ownerType", 
        "complianceState", 
        "OS", 
        "OSVersion", 
        "LastContact", 
        "UPN", 
        "DeviceId" 
    ]
}

Nota

Para obter dados, selecione colunas específicas, como as especificadas no exemplo acima. Não construa automatização em torno de colunas predefinidos de qualquer exportação de relatório. Deve construir a sua automatização para selecionar explicitamente colunas relevantes.

Exemplo de resposta

Com base no pedido de POST acima, Graph devolve uma mensagem de resposta. A mensagem de resposta são os dados que solicitou ou o resultado da operação.

{ 
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#deviceManagement/reports/exportJobs/$entity", 
    "id": "Devices_05e62361-783b-4cec-b635-0aed0ecf14a3", 
    "reportName": "Devices", 
    "filter":"(OwnerType eq '1')", 
    "localizationType": "LocalizedValuesAsAdditionalColumn", 
    "select": [ 
        "DeviceName", 
        "managementAgent", 
        "ownerType", 
        "complianceState", 
        "OS", 
        "OSVersion", 
        "LastContact", 
        "UPN", 
        "DeviceId" 
    ], 
    "format": "csv", 
    "snapshotId": null, 
    "status": "notStarted", 
    "url": null, 
    "requestDateTime": "2020-08-19T03:43:32.1405758Z", 
    "expirationDateTime": "0001-01-01T00:00:00Z" 
}

Em seguida, pode utilizar o id campo para consultar o estado da exportação com um pedido GET:

Por exemplo: https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs('Devices_05e62361-783b-4cec-b635-0aed0ecf14a3')

Você precisará continuar a ligar para este URL até obter uma resposta com um status: completed atributo. Será o seguinte exemplo:

{ 
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#deviceManagement/reports/exportJobs/$entity", 
    "id": "Devices_05e62361-783b-4cec-b635-0aed0ecf14a3", 
    "reportName": "Devices", 
    "filter":"(OwnerType eq '1')", 
    "localizationType": "LocalizedValuesAsAdditionalColumn", 
    "select": [ 
        "DeviceName", 
        "managementAgent", 
        "ownerType", 
        "complianceState", 
        "OS", 
        "OSVersion", 
        "LastContact", 
        "UPN", 
        "DeviceId" 
    ], 
    "format": "csv", 
    "snapshotId": null, 
    "status": "completed", 
    "url": "https://amsua0702repexpstorage.blob.core.windows.net/cec055a4-97f0-4889-b790-dc7ad0d12c29/Devices_05e62361-783b-4cec-b635-0aed0ecf14a3.zip?sv=2019-02-02&sr=b&sig=%2BP%2B4gGiZf0YzlQRuAV5Ji9Beorg4nnOtP%2F7bbFGH7GY%3D&skoid=1db6df02-4c8b-4cb3-8394-7ac2390642f8&sktid=72f988bf-86f1-41af-91ab-2d7cd011db47&skt=2020-08-19T03%3A48%3A32Z&ske=2020-08-19T09%3A44%3A23Z&sks=b&skv=2019-02-02&se=2020-08-19T09%3A44%3A23Z&sp=r", 
    "requestDateTime": "2020-08-19T03:43:32.1405758Z", 
    "expirationDateTime": "2020-08-19T09:44:23.8540289Z" 
}

Em seguida, pode baixar diretamente o CSV comprimido do url campo.

Parâmetros do relatório

Existem quatro parâmetros principais que pode submeter no seu órgão de pedido para definir o pedido de exportação:

  • reportName: Obrigatório. Este parâmetro é o nome do relatório que pretende especificar.
  • filter: Não é necessário para a maioria dos relatórios. Note que o parâmetro do filtro é uma corda.
  • select: Não é necessário. Especifique quais as colunas do relatório que deseja. Apenas serão aceites os nomes de colunas válidos relevantes para o relatório que está a ligar.
  • localizationType: Este parâmetro controla o comportamento de localização do relatório. Os valores possíveis são LocalizedValuesAsAdditionalColumn ReplaceLocalizableValues e.

Comportamento de localização

O localizationType parâmetro controla o comportamento de localização do relatório. Os valores possíveis para este parâmetro são LocalizedValuesAsAdditionalColumn e ReplaceLocalizableValues .

Valor do relatório LocalValuesAdditionalColumn

Este valor para o localizationType parâmetro é o valor padrão. Será inserido automaticamente se o localizationType parâmetro não for especificado. Este valor especifica que o Intune fornece duas colunas para cada coluna pecável.

  • valor enum: A coluna de valor enum contém uma corda crua, ou um conjunto de números que não mudam, independentemente do local. Esta coluna ficará sob o nome da coluna original (ver exemplo).
  • valor de cadeia localizado: Esta coluna será o nome original da coluna com _loc anexado. Conterá valores de cordas que são legíveis pelo homem e localidade condicional (ver exemplo).

Exemplo

SO OS_loc
1 Windows
1 Windows
1 Windows
2 iOS
3 Android
4 Mac

Substituir Valor do relatório LocalcalizableValues

Substituir O valor do relatório LocalcalizableValues só devolverá uma coluna por atributo localizado. Esta coluna conterá o nome da coluna original com os valores localizados.

Exemplo

SO
Windows
Windows
Windows
iOS
Android
Mac

Para colunas sem valores localizados, apenas uma coluna com o nome da coluna verdadeira e os verdadeiros valores da coluna são devolvidos.

Importante

O localizationType parâmetro é relevante para qualquer experiência de exportação hospedada pela infraestrutura de reporte da Intune com algumas exceções. Os Devices tipos e os tipos de relatório não DevicesWithInventory honrarão o parâmetro devido aos localizationType requisitos de compatibilidade do legado.

Passos seguintes