Eksportowanie raportów usługi Intune za pomocą interfejsów Graph APIExport Intune reports using Graph APIs

Wszystkie raporty zmigrowane do infrastruktury raportowania usługi Intune będą dostępne do eksportu z pojedynczego interfejsu API eksportowania na najwyższym poziomie.All reports that have been migrated to the Intune reporting infrastructure will be available for export from a single top-level export API. Trzeba używać interfejsu Microsoft Graph API do wywołania protokołu HTTP.You must use the Microsoft Graph API to make the HTTP call. Microsoft Graph to internetowy interfejs API typu RESTful, który umożliwia dostęp do zasobów usługi Microsoft Cloud.Microsoft Graph is a RESTful web API that enables you to access Microsoft Cloud service resources.

Uwaga

Aby uzyskać informacje na temat tworzenia wywołań interfejsu API REST, w tym narzędzi do współpracy z rozwiązaniem Microsoft Graph, zobacz artykuł Use the Microsoft Graph API (Użycie interfejsu Microsoft Graph API).For information about making REST API calls, including tools for interacting with Microsoft Graph, see Use the Microsoft Graph API.

Program Microsoft Endpoint Manager będzie eksportować raporty w oparciu o następujący punkt końcowy interfejsu Microsoft Graph API:Microsoft Endpoint Manager will export reports based on the following Microsoft Graph API endpoint:

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

Przykładowe żądanie i odpowiedź raportu o urządzeniachExample devices report request and response

Podczas wykonywania żądania należy podać parametr reportName jako część treści żądania na podstawie raportu, który chcesz wyeksportować.When making the request, you must provide a reportName parameter as part of the request body based on the report that you would like to export. Poniżej znajduje się przykład żądania eksportu dla raportu Devices (Urządzenia).Below is an example of an export request for the Devices report. W żądaniu musisz użyć metody POST protokołu HTTP.You must use the POST HTTP method on your request. Metoda POST służy do tworzenia nowego zasobu lub wykonywania akcji.The POST method is used to create a new resource or perform an action.

Przykład żądaniaRequest example

Poniższe żądanie zawiera metodę HTTP używaną w żądaniu do interfejsów Microsoft Graph.The below request contains the HTTP method used on the request to Microsoft Graph.

{ 
    "reportName": "Devices", 
    "filter": "", 
    "select": [ 
        "DeviceName", 
        "managementAgent", 
        "ownerType", 
        "complianceState", 
        "OS", 
        "OSVersion", 
        "LastContact", 
        "UPN", 
        "DeviceId" 
    ]
} 

Przykład odpowiedziResponse example

Na podstawie powyższego żądania POST rozwiązanie Graph zwraca komunikat odpowiedzi.Based on the above POST request, Graph returns a response message. Komunikat odpowiedzi to żądane dane lub wynik operacji.The response message is the data that you requested or the result of the operation.

{ 
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#deviceManagement/reports/exportJobs/$entity", 
    "id": "Devices_05e62361-783b-4cec-b635-0aed0ecf14a3", 
    "reportName": "Devices", 
    "filter": "", 
    "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" 
} 

Następnie można użyć pola id, aby zapytać o stan eksportu przy użyciu żądania GET:You can then use the id field to query the status of the export with a GET request:

Na przykład: https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs('Devices_05e62361-783b-4cec-b635-0aed0ecf14a3') For example: https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs('Devices_05e62361-783b-4cec-b635-0aed0ecf14a3')

Należy kontynuować wywoływanie tego adresu URL do momentu otrzymania odpowiedzi z atrybutem status: completed.You will need to continue calling this URL until you get a response with a status: completed attribute. Wyniki będą wyglądać podobnie do następującego przykładu:It will look like the following example:

{ 
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#deviceManagement/reports/exportJobs/$entity", 
    "id": "Devices_05e62361-783b-4cec-b635-0aed0ecf14a3", 
    "reportName": "Devices", 
    "filter": "", 
    "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" 
} 

Następnie można bezpośrednio pobrać skompresowany plik CSV z pola url.You can then directly download the compressed CSV from the url field.

Parametry raportuReport parameters

Istnieją trzy główne parametry, które można przesłać w treści żądania, aby zdefiniować żądanie eksportu:There are three main parameters you can submit in your request body to define the export request:

  • reportName: Wymagany.reportName: Required. Ten parametr jest nazwą raportu, który ma zostać określony.This parameter is the name of the report you want to specify.
  • filter: Niewymagane w przypadku większości raportów.filter: Not required for most reports.
  • select: Niewymagane.select: Not required. Jeśli nie określisz wartości select, zostanie wyświetlony domyślny zestaw kolumn, który dla większości raportów obejmuje cały zestaw danych.If you don't specify a select value you will receive a default set of columns, which for most reports is the entire dataset.

Dostępne raportyAvailable reports

Poniższa tabela zawiera możliwe wartości parametru reportName.The following table contains the possible values for the reportName parameter. Są to obecnie dostępne raporty do eksportowania.These are the currently available reports for export.

ReportName (parametr eksportu)ReportName (Export Parameter) Raport skojarzony w programie Microsoft Endpoint ManagerAssociated Report in Microsoft Endpoint Manager
DeviceComplianceDeviceCompliance Zgodność urządzenia w organizacjiDevice Compliance Org
DeviceNonComplianceDeviceNonCompliance Niezgodne urządzeniaNon-compliant devices
DevicesDevices Lista wszystkich urządzeńAll devices list
DetectedAppsAggregateDetectedAppsAggregate Raport o wykrytych aplikacjachDetected Apps report
FeatureUpdatePolicyFailuresAggregateFeatureUpdatePolicyFailuresAggregate Kliknij kolejno pozycje Devices (Urządzenia) > Monitor (Monitoruj) > Failure for feature updates (Niepowodzenie aktualizacji funkcji)Under Devices > Monitor > Failure for feature updates
DeviceFailuresByFeatureUpdatePolicyDeviceFailuresByFeatureUpdatePolicy Kliknij kolejno pozycje Devices (Urządzenia) > Monitor (Monitoruj) > Failure for feature updates (Niepowodzenie aktualizacji funkcji) > kliknij błądUnder Devices > Monitor > Failure for feature updates > click on error
FeatureUpdateDeviceStateFeatureUpdateDeviceState Kliknij kolejno pozycje Reports (Raporty) > Windows Update > Reports (Raporty) > Windows Feature Update Report (Raport aktualizacji funkcji Windows) Under Reports > Window Updates > Reports > Windows Feature Update Report
UnhealthyDefenderAgentsUnhealthyDefenderAgents Kliknij kolejno pozycje Endpoint Security (Zabezpieczenia punktu końcowego) > Antivirus (Oprogramowanie antywirusowe) > Win10 Unhealthy Endpoints (Punkty końcowe systemu Windows 10 będące w złej kondycji)Under Endpoint Security > Antivirus > Win10 Unhealthy Endpoints
DefenderAgentsDefenderAgents Kliknij kolejno pozycje Reports (Raporty) > MicrosoftDefender > Reports (Raporty) > Agent Status (Stan agenta)Under Reports > MicrosoftDefender > Reports > Agent Status
ActiveMalwareActiveMalware Kliknij kolejno pozycje Endpoint Security (Zabezpieczenia punktu końcowego) > Antivirus (Oprogramowanie antywirusowe) > Win10 detected malware (Złośliwe oprogramowanie wykryte w systemie Windows 10)Under Endpoint Security > Antivirus > Win10 detected malware
Złośliwe oprogramowanieMalware Kliknij kolejno pozycje Reports (Raporty) > MicrosoftDefender > Reports (Raporty) > Detected malware (Wykryte złośliwe oprogramowanie)Under Reports > MicrosoftDefender > Reports > Detected malware

Każdy z wymienionych raportów został opisany poniżej.Each of the listed reports is described below.

Raport DeviceComplianceDeviceCompliance report

Poniższa tabela zawiera możliwe dane wyjściowe podczas wywoływania raportu DeviceCompliance:The following table contains the possible output when calling the DeviceCompliance report:

Dostępne właściwościAvailable properties
DeviceIdDeviceId
IntuneDeviceIdIntuneDeviceId
AadDeviceIdAadDeviceId
DeviceNameDeviceName
DeviceTypeDeviceType
OSDescriptionOSDescription
OSVersionOSVersion
OwnerTypeOwnerType
LastContactLastContact
InGracePeriodUntilInGracePeriodUntil
IMEIIMEI
SerialNumberSerialNumber
ManagementAgentsManagementAgents
PrimaryUserPrimaryUser
UserIdUserId
UPN (Nazwa UPN)UPN
UserEmailUserEmail
Nazwa użytkownikaUserName
DeviceHealthThreatLevelDeviceHealthThreatLevel
RetireAfterDatetimeRetireAfterDatetime
PartnerDeviceIdPartnerDeviceId
ComplianceStateComplianceState
System operacyjnyOS

Można wybrać, aby filtrować dane wyjściowe raportu DeviceCompliance w oparciu o następujące kolumny:You can choose to filter the DeviceCompliance report's output based on the following columns:

  • ComplianceState
  • OS
  • OwnerType
  • DeviceType

Raport DeviceNonComplianceDeviceNonCompliance report

Poniższa tabela zawiera możliwe dane wyjściowe podczas wywoływania raportu DeviceNonCompliance:The following table contains the possible output when calling the DeviceNonCompliance report:

Dostępne właściwościAvailable properties
DeviceIdDeviceId
IntuneDeviceIdIntuneDeviceId
AadDeviceIdAadDeviceId
DeviceNameDeviceName
DeviceTypeDeviceType
OSDescriptionOSDescription
OSVersionOSVersion
OwnerTypeOwnerType
LastContactLastContact
InGracePeriodUntilInGracePeriodUntil
IMEIIMEI
SerialNumberSerialNumber
ManagementAgentsManagementAgents
PrimaryUserPrimaryUser
UserIdUserId
UPN (Nazwa UPN)UPN
UserEmailUserEmail
Nazwa użytkownikaUserName
DeviceHealthThreatLevelDeviceHealthThreatLevel
RetireAfterDatetimeRetireAfterDatetime
PartnerDeviceIdPartnerDeviceId
ComplianceStateComplianceState
System operacyjnyOS

Można wybrać, aby filtrować dane wyjściowe raportu DeviceNonCompliance w oparciu o następujące kolumny:You can choose to filter the DeviceNonCompliance report's output based on the following columns:

  • OS
  • OwnerType
  • DeviceType
  • UserId
  • ComplianceState

Raport DevicesDevices report

Poniższa tabela zawiera możliwe dane wyjściowe podczas wywoływania raportu Devices:The following table contains the possible output when calling the Devices report:

Dostępne właściwościAvailable properties
DeviceIdDeviceId
DeviceNameDeviceName
DeviceTypeDeviceType
ClientRegistrationStatusClientRegistrationStatus
OwnerTypeOwnerType
CreatedDateCreatedDate
LastContactLastContact
ManagementAgentsManagementAgents
ManagementStateManagementState
Identyfikator odwołaniaReferenceId
CategoryIdCategoryId
EnrollmentTypeEnrollmentType
CertExpirationDateCertExpirationDate
MDMStatusMDMStatus
OSVersionOSVersion
GraphDeviceIsManagedGraphDeviceIsManaged
EasIDEasID
SerialNumberSerialNumber
EnrolledByUserEnrolledByUser
ProducentManufacturer
ModelModel
OSDescriptionOSDescription
IsManagedIsManaged
EasActivationStatusEasActivationStatus
IMEIIMEI
EasLastSyncSuccessUtcEasLastSyncSuccessUtc
EasStateReasonEasStateReason
EasAccessStateEasAccessState
EncryptionStatusEncryptionStatus
SupervisedStatusSupervisedStatus
PhoneNumberE164FormatPhoneNumberE164Format
InGracePeriodUntilInGracePeriodUntil
AndroidPatchLevelAndroidPatchLevel
WifiMacAddressWifiMacAddress
SCCMCoManagementFeaturesSCCMCoManagementFeatures
MEIDMEID
SubscriberCarrierNetworkSubscriberCarrierNetwork
StorageTotalStorageTotal
StorageFreeStorageFree
ManagedDeviceNameManagedDeviceName
LastLoggedOnUserUPNLastLoggedOnUserUPN
MDMWinsOverGPStartTimeMDMWinsOverGPStartTime
StagedDeviceTypeStagedDeviceType
UserApprovedEnrollmentUserApprovedEnrollment
ExtendedPropertiesExtendedProperties
EntitySourceEntitySource
PrimaryUserPrimaryUser
CategoryNameCategoryName
UserIdUserId
UPN (Nazwa UPN)UPN
UserEmailUserEmail
Nazwa użytkownikaUserName
RetireAfterDatetimeRetireAfterDatetime
PartnerDeviceIdPartnerDeviceId
HasUnlockTokenHasUnlockToken
CompliantStateCompliantState
ManagedByManagedBy
WłasnośćOwnership
DeviceStateDeviceState
DeviceRegistrationStateDeviceRegistrationState
SupervisedStatusStringSupervisedStatusString
EncryptionStatusStringEncryptionStatusString
System operacyjnyOS
SkuFamilySkuFamily
JoinTypeJoinType
PhoneNumberPhoneNumber
JailBrokenJailBroken
EasActivationStatusStringEasActivationStatusString

Można wybrać, aby filtrować dane wyjściowe raportu Devices w oparciu o następujące kolumny:You can choose to filter the Devices report's output based on the following columns:

  • OwnerType
  • DeviceType
  • ManagementAgents
  • CategoryName
  • ManagementState
  • CompliantState
  • JailBroken
  • LastContact
  • CreatedDate
  • EnrollmentType

Raport DetectedAppsAggregateDetectedAppsAggregate report

Poniższa tabela zawiera możliwe dane wyjściowe podczas wywoływania raportu DetectedAppsAggregate:The following table contains the possible output when calling the DetectedAppsAggregate report:

Dostępne właściwościAvailable properties
ApplicationKeyApplicationKey
ApplicationNameApplicationName
ApplicationVersionApplicationVersion
DeviceCountDeviceCount
BundleSizeBundleSize

Można wybrać, aby filtrować dane wyjściowe raportu DetectedAppsAggregate w oparciu o następującej kolumny:You can choose to filter the DetectedAppsAggregate report's output based on the following column:

  • ApplicationName

Raport FeatureUpdatePolicyFailuresAggregateFeatureUpdatePolicyFailuresAggregate report

Poniższa tabela zawiera możliwe dane wyjściowe podczas wywoływania raportu FeatureUpdatePolicyFailuresAggregate:The following table contains the possible output when calling the FeatureUpdatePolicyFailuresAggregate report:

Dostępne właściwościAvailable properties
PolicyIdPolicyId
PolicyNamePolicyName
FeatureUpdateVersionFeatureUpdateVersion
NumberOfDevicesWithErrorsNumberOfDevicesWithErrors

Nie można filtrować tego raportu.You cannot filter this report.

Raport DeviceFailuresByFeatureUpdatePolicyDeviceFailuresByFeatureUpdatePolicy report

Poniższa tabela zawiera możliwe dane wyjściowe podczas wywoływania raportu DeviceFailuresByFeatureUpdatePolicy:The following table contains the possible output when calling the DeviceFailuresByFeatureUpdatePolicy report:

Dostępne właściwościAvailable properties
PolicyIdPolicyId
PolicyNamePolicyName
FeatureUpdateVersionFeatureUpdateVersion
DeviceIdDeviceId
AADDeviceIdAADDeviceId
AlertIdAlertId
EventDateTimeUTCEventDateTimeUTC
LastUpdatedAlertStatusDateTimeUTCLastUpdatedAlertStatusDateTimeUTC
AlertTypeAlertType
AlertStatusAlertStatus
AlertClassificationAlertClassification
WindowsUpdateVersionWindowsUpdateVersion
KompilacjaBuild
AlertMessageAlertMessage
AlertMessageDescriptionAlertMessageDescription
AlertMessageDataAlertMessageData
Win32ErrorCodeWin32ErrorCode
RecommendedActionRecommendedAction
ExtendedRecommendedActionExtendedRecommendedAction
StartDateTimeUTCStartDateTimeUTC
ResolvedDateTimeUTCResolvedDateTimeUTC
DeviceNameDeviceName
UPN (Nazwa UPN)UPN

Można wybrać, aby filtrować dane wyjściowe raportu DeviceFailuresByFeatureUpdatePolicy w oparciu o następujące kolumny:You can choose to filter the DeviceFailuresByFeatureUpdatePolicy report's output based on the following columns:

  • PolicyId (Wymagane)PolicyId (Required)
  • AlertMessage
  • RecommendedAction
  • WindowsUpdateVersion

Raport FeatureUpdateDeviceStateFeatureUpdateDeviceState report

Poniższa tabela zawiera możliwe dane wyjściowe podczas wywoływania raportu FeatureUpdateDeviceState:The following table contains the possible output when calling the FeatureUpdateDeviceState report:

Dostępne właściwościAvailable properties
PolicyIdPolicyId
PolicyNamePolicyName
FeatureUpdateVersionFeatureUpdateVersion
DeviceIdDeviceId
AADDeviceIdAADDeviceId
PartnerPolicyIdPartnerPolicyId
EventDateTimeUTCEventDateTimeUTC
LastSuccessfulDeviceUpdateStatusLastSuccessfulDeviceUpdateStatus
LastSuccessfulDeviceUpdateSubstatusLastSuccessfulDeviceUpdateSubstatus
LastSuccessfulDeviceUpdateStatusEventDateTimeUTCLastSuccessfulDeviceUpdateStatusEventDateTimeUTC
CurrentDeviceUpdateStatusCurrentDeviceUpdateStatus
CurrentDeviceUpdateSubstatusCurrentDeviceUpdateSubstatus
CurrentDeviceUpdateStatusEventDateTimeUTCCurrentDeviceUpdateStatusEventDateTimeUTC
LatestAlertMessageLatestAlertMessage
LatestAlertMessageDescriptionLatestAlertMessageDescription
LatestAlertRecommendedActionLatestAlertRecommendedAction
LatestAlertExtendedRecommendedActionLatestAlertExtendedRecommendedAction
UpdateCategoryUpdateCategory
WindowsUpdateVersionWindowsUpdateVersion
LastWUScanTimeUTCLastWUScanTimeUTC
KompilacjaBuild
DeviceNameDeviceName
OwnerTypeOwnerType
UPN (Nazwa UPN)UPN
AggregateStateAggregateState

Można wybrać, aby filtrować dane wyjściowe raportu FeatureUpdateDeviceState w oparciu o następujące kolumny:You can choose to filter the FeatureUpdateDeviceState report's output based on the following columns:

  • PolicyId (Wymagane)PolicyId (Required)
  • AggregateState
  • LatestAlertMessage
  • OwnerType

Raporty UnhealthyDefenderAgents i DefenderAgentsUnhealthyDefenderAgents and DefenderAgents reports

Raporty UnhealthyDefenderAgents i DefenderAgents to dwa odrębne raporty, które mają ten sam zestaw właściwości i filtrów.The UnhealthyDefenderAgents and DefenderAgents reports are two distinct reports that have the same set of properties and filters. Poniższa tabela zawiera możliwe dane wyjściowe podczas wywoływania raportów UnhealthyDefenderAgents lub DefenderAgents:The following table contains the possible output when calling the UnhealthyDefenderAgents or DefenderAgents reports:

Dostępne kolumnyAvailable Columns
DeviceIdDeviceId
DeviceNameDeviceName
DeviceStateDeviceState
PendingFullScanPendingFullScan
PendingRebootPendingReboot
PendingManualStepsPendingManualSteps
PendingOfflineScanPendingOfflineScan
CriticalFailureCriticalFailure
MalwareProtectionEnabledMalwareProtectionEnabled
RealTimeProtectionEnabledRealTimeProtectionEnabled
NetworkInspectionSystemEnabledNetworkInspectionSystemEnabled
SignatureUpdateOverdueSignatureUpdateOverdue
QuickScanOverdueQuickScanOverdue
FullScanOverdueFullScanOverdue
RebootRequiredRebootRequired
FullScanRequiredFullScanRequired
EngineVersionEngineVersion
SignatureVersionSignatureVersion
AntiMalwareVersionAntiMalwareVersion
LastQuickScanDateTimeLastQuickScanDateTime
LastFullScanDateTimeLastFullScanDateTime
LastQuickScanSignatureVersionLastQuickScanSignatureVersion
LastFullScanSignatureVersionLastFullScanSignatureVersion
LastReportedDateTimeLastReportedDateTime
UPN (Nazwa UPN)UPN
UserEmailUserEmail
Nazwa użytkownikaUserName

Można wybrać, aby filtrować dane wyjściowe raportów UnhealthyDefenderAgents i DefenderAgents w oparciu o następujące kolumny:You can choose to filter the UnhealthyDefenderAgents and DefenderAgents report's output based on the following columns:

  • DeviceState
  • SignatureUpdateOverdue
  • MalwareProtectionEnabled
  • RealTimeProtectionEnabled
  • NetworkInspectionSystemEnabled

Raporty ActiveMalware i MalwareActiveMalware and Malware reports

Raporty ActiveMalware i Malware to dwa odrębne raporty, które mają ten sam zestaw właściwości i filtrów.The ActiveMalware and Malware reports are two distinct reports that have the same set of properties and filters. Poniższa tabela zawiera możliwe dane wyjściowe podczas wywoływania raportów ActiveMalware lub Malware:The following table contains the possible output when calling the ActiveMalware or Malware reports:

Dostępne kolumnyAvailable Columns
DeviceIdDeviceId
DeviceNameDeviceName
MalwareIdMalwareId
MalwareNameMalwareName
AdditionalInformationUrlAdditionalInformationUrl
WażnośćSeverity
MalwareCategoryMalwareCategory
ExecutionStateExecutionState
StateState
InitialDetectionDateTimeInitialDetectionDateTime
LastStateChangeDateTimeLastStateChangeDateTime
DetectionCountDetectionCount
UPN (Nazwa UPN)UPN
UserEmailUserEmail
Nazwa użytkownikaUserName

Można wybrać, aby filtrować dane wyjściowe raportów ActiveMalware i Malware w oparciu o następujące kolumny:You can choose to filter the ActiveMalware and Malware report's output based on the following columns:

  • Severity
  • ExecutionState
  • State

Następne krokiNext steps