Exporter l’évaluation de l’inventaire logiciel par appareilExport software inventory assessment per device

S’applique à :Applies to:

Vous souhaitez découvrir Microsoft Defender pour le point de terminaison ?Want to experience Microsoft Defender for Endpoint? Inscrivez-vous à un essai gratuit.Sign up for a free trial.

Important

Certaines informations ont trait à un produit préalablement publié, qui peut être modifié de manière significative avant sa publication commerciale.Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft n’offre aucune garantie, explicite ou implicite, concernant les informations fournies ici.Microsoft makes no warranties, express or implied, with respect to the information provided here.

Il existe différents appels d’API pour obtenir différents types de données.There are different API calls to get different types of data. Étant donné que la quantité de données peut être importante, il existe deux façons de les récupérer :Because the amount of data can be large, there are two ways it can be retrieved:

  • Exporter l’évaluation de l’inventaire logiciel OData L’API pulls all data in your organization as Json responses, following the OData protocol.Export software inventory assessment OData The API pulls all data in your organization as Json responses, following the OData protocol. Cette méthode est la meilleure pour les petites organisations avec moins de 100 Ko d’appareils.This method is best for small organizations with less than 100-K devices. La réponse est paginée, afin que vous pouvez utiliser le champ odata.nextLink de la réponse @ pour récupérer les résultats suivants.The response is paginated, so you can use the @odata.nextLink field from the response to fetch the next results.

  • Exporter l’évaluation de l’inventaire logiciel via des fichiers Cette solution d’API permet d’tirer plus rapidement et de manière plus fiable des données plus volumineuses.Export software inventory assessment via files This API solution enables pulling larger amounts of data faster and more reliably. Par conséquent, il est recommandé pour les grandes organisations, avec plus de 100 Ko d’appareils.Therefore, it is recommended for large organizations, with more than 100-K devices. Cette API tire toutes les données de votre organisation en tant que fichiers de téléchargement.This API pulls all data in your organization as download files. La réponse contient des URL pour télécharger toutes les données à partir de stockage Azure.The response contains URLs to download all the data from Azure Storage. Cette API vous permet de télécharger toutes vos données à partir stockage Azure comme suit :This API enables you to download all your data from Azure Storage as follows:

    • Appelez l’API pour obtenir la liste des URL de téléchargement avec toutes les données de votre organisation.Call the API to get a list of download URLs with all your organization data.

    • Téléchargez tous les fichiers à l’aide des URL de téléchargement et traiter les données comme vous le souhaitez.Download all the files using the download URLs and process the data as you like.

Les données collectées (à l’aide d’OData ou via des fichiers) sont l’instantané actuel de l’état actuel et ne contiennent pas de données historiques.Data that is collected (using either OData or via files) is the current snapshot of the current state, and does not contain historic data. Pour collecter des données historiques, les clients doivent les enregistrer dans leurs propres stockages de données.In order to collect historic data, customers must save the data in their own data storages.

Notes

Sauf indication contraire, toutes les méthodes **** d’évaluation d’exportation répertoriées sont l’exportation complète et par appareil (également appelé par appareil).Unless indicated otherwise, all export assessment methods listed are full export and by device (also referred to as per device).

1. Exporter l’évaluation de l’inventaire logiciel (OData)1. Export software inventory assessment (OData)

1.1 Description de la méthode API1.1 API method description

Cette réponse API contient toutes les données des logiciels installés par appareil.This API response contains all the data of installed software per device. Renvoie un tableau avec une entrée pour chaque combinaison unique de DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion.Returns a table with an entry for every unique combination of DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion.

LimitesLimitations

  • La taille maximale de page est de 200 000.Maximum page size is 200,000.

  • Les limites de taux pour cette API sont de 30 appels par minute et de 1 000 appels par heure.Rate limitations for this API are 30 calls per minute and 1000 calls per hour.

1.2 Autorisations1.2 Permissions

L’une des autorisations suivantes est nécessaire pour appeler cette API.One of the following permissions is required to call this API. Pour plus d’informations, notamment sur le choix des autorisations, voir Utiliser Microsoft Defender pour les API de point de terminaison pour plus d’informations.To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

Type d’autorisationPermission type AutorisationPermission Nom d’affichage de l’autorisationPermission display name
ApplicationApplication Software.Read.AllSoftware.Read.All 'Lire les informations sur les vulnérabilités de gestion des menaces et des vulnérabilités''Read Threat and Vulnerability Management vulnerability information'
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Software.ReadSoftware.Read 'Lire les informations sur les vulnérabilités de gestion des menaces et des vulnérabilités''Read Threat and Vulnerability Management vulnerability information'

1.3 URL1.3 URL

GET /api/machines/SoftwareInventoryByMachine

1.4 Paramètres1.4 Parameters

  • pageSize (valeur par défaut = 50 000) : nombre de résultats en réponse.pageSize (default = 50,000) – number of results in response.

  • $top : nombre de résultats à renvoyer (ne retourne pas @odata.nextLink et, par conséquent, ne tire pas toutes les données)$top – number of results to return (doesn’t return @odata.nextLink and therefore doesn’t pull all the data)

1.5 Propriétés1.5 Properties

Notes

-Chaque enregistrement représente environ 0,5KB de données.-Each record is approximately 0.5KB of data. Vous devez prendre cela en compte lors du choix du paramètre pageSize approprié pour vous.You should take this into account when choosing the correct pageSize parameter for you.

-Les propriétés définies dans le tableau suivant sont répertoriées par ordre alphabétique, par ID de propriété.-The properties defined in the following table are listed alphabetically, by property ID. Lors de l’exécution de cette API, la sortie résultante ne sera pas nécessairement renvoyée dans le même ordre que celui répertorié dans ce tableau.When running this API, the resulting output will not necessarily be returned in the same order listed in this table.

-Certaines colonnes supplémentaires peuvent être renvoyées dans la réponse.-Some additional columns might be returned in the response. Ces colonnes sont temporaires et peuvent être supprimées. Utilisez uniquement les colonnes documentées.These columns are temporary and might be removed, please use only the documented columns.

Propriété (ID)Property (ID) Type de donnéesData type DescriptionDescription Exemple de valeur renvoyéeExample of a returned value
DeviceIdDeviceId stringstring Identificateur unique de l’appareil dans le service.Unique identifier for the device in the service. 9eaf3a8b5962e0e6b1af9ec756664a9b823df2d19eaf3a8b5962e0e6b1af9ec756664a9b823df2d1
DeviceNameDeviceName stringstring Nom de domaine complet (FQDN) de l’appareil.Fully qualified domain name (FQDN) of the device. johnlaptop.europe.contoso.comjohnlaptop.europe.contoso.com
DiskPathsDiskPaths Array[string]Array[string] Preuve disque que le produit est installé sur l’appareil.Disk evidence that the product is installed on the device. [ « C: \ Program Files (x86) \ Microsoft \ Silverlight \ Application \silverlight.exe » ][ "C:\Program Files (x86)\Microsoft\Silverlight\Application\silverlight.exe" ]
EndOfSupportDateEndOfSupportDate stringstring Date à laquelle la prise en charge de ce logiciel a ou va se terminer.The date in which support for this software has or will end. 2020-12-302020-12-30
EndOfSupportStatusEndOfSupportStatus stringstring État de fin du support.End of support status. Peut contenir les valeurs possibles : None, EOS Version, Future EOS Version, EOS Software, Upcoming EOS Software.Can contain these possible values: None, EOS Version, Upcoming EOS Version, EOS Software, Upcoming EOS Software. EOS à venirUpcoming EOS
IDId stringstring Identificateur unique de l’enregistrement.Unique identifier for the record. 123ABG55_573AG&mnp !123ABG55_573AG&mnp!
NumberOfWeaknessesNumberOfWeaknesses entierint Nombre de faiblesses sur ce logiciel sur cet appareilNumber of weaknesses on this software on this device 33
OSPlatformOSPlatform stringstring Plateforme du système d’exploitation en cours d’exécution sur l’appareil.Platform of the operating system running on the device. Cela indique des systèmes d’exploitation spécifiques, y compris des variantes au sein d’une même famille, telles que Windows 10 et Windows 7.This indicates specific operating systems, including variations within the same family, such as Windows 10 and Windows 7. Pour plus d’informations, voir les systèmes d’exploitation et les plateformes pris en charge par tvm.See tvm supported operating systems and platforms for details. Windows 10Windows10
RbacGroupNameRbacGroupName stringstring Groupe de contrôle d’accès basé sur un rôle (RBAC).The role-based access control (RBAC) group. Si cet appareil n’est affecté à aucun groupe RBAC, la valeur sera « Unassigned ».If this device is not assigned to any RBAC group, the value will be “Unassigned.” Si l’organisation ne contient aucun groupe RBAC, la valeur sera « None ».If the organization doesn’t contain any RBAC groups, the value will be “None.” ServeursServers
RegistryPathsRegistryPaths Array[string]Array[string] Preuve dans le Registre que le produit est installé sur l’appareil.Registry evidence that the product is installed in the device. [ « HKEY_LOCAL_MACHINE \ SOFTWARE \ WOW6432Node \ Microsoft Windows \ \ CurrentVersion \ Uninstall Microsoft \ Silverlight » ][ "HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\Microsoft Silverlight" ]
SoftwareFirstSeenTimestampSoftwareFirstSeenTimestamp stringstring La première fois que ce logiciel a été vu sur l’appareil.The first time this software was seen on the device. 2019-04-07 02:06:472019-04-07 02:06:47
SoftwareNameSoftwareName stringstring Nom du produit logiciel.Name of the software product. SilverlightSilverlight
SoftwareVendorSoftwareVendor stringstring Nom du fournisseur de logiciels.Name of the software vendor. microsoftmicrosoft
SoftwareVersionSoftwareVersion stringstring Numéro de version du produit logiciel.Version number of the software product. 81.0.4044.13881.0.4044.138

1.6 Exemples1.6 Examples

1.6.1 Exemple de requête1.6.1 Request example

GET https://api.securitycenter.microsoft.com/api/machines/SoftwareInventoryByMachine?pageSize=5  &sinceTime=2021-05-19T18%3A35%3A49.924Z 

1.6.2 Exemple de réponse1.6.2 Response example

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Collection(contoso.windowsDefenderATP.api.AssetSoftware)",
    "value": [
        {
            "deviceId": "00044f68765bbaf712342dbe6db733b6a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18993b45912eeb224b2be2f5ea3142726e63f16a.DomainPII_21eeb80d086e79dbfa178eadfa25e8de9acfa346.corp.contoso.com",
            "osPlatform": "Windows10",
            "softwareVendor": "microsoft",
            "softwareName": "windows_10",
            "softwareVersion": "10.0.17763.1637",
            "numberOfWeaknesses": 58,
            "diskPaths": [],
            "registryPaths": [],
            "softwareFirstSeenTimestamp": "2020-12-30 11:07:15",
            "endOfSupportStatus": "Upcoming EOS Version",
            "endOfSupportDate": "2021-05-11T00:00:00+00:00"
        },
        {
            "deviceId": "00044f68765bbaf712342dbe6db733b6a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18993b45912eeb224b2be2f5ea3142726e63f16a.DomainPII_21eeb80d086e79dbfa178eadfa25e8de9acfa346.corp.contoso.com",
            "osPlatform": "Windows10",
            "softwareVendor": "microsoft",
            "softwareName": ".net_framework",
            "softwareVersion": "4.0.0.0",
            "numberOfWeaknesses": 0,
            "diskPaths": [],
            "registryPaths": [
                "SOFTWARE\\Microsoft\\NET Framework Setup\\NDP\\v4.0\\Client\\Install"
            ],
            "softwareFirstSeenTimestamp": "2020-12-30 11:07:15",
            "endOfSupportStatus": "None",
            "endOfSupportDate": null
        },
        {
            "deviceId": "00044f68765bbaf712342dbe6db733b6a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18993b45912eeb224b2be2f5ea3142726e63f16a.DomainPII_21eed80d086e79bdfa178eadfa25e8de9acfa346.corp.contoso.com",
            "osPlatform": "Windows10",
            "softwareVendor": "microsoft",
            "softwareName": "system_center_2012_endpoint_protection",
            "softwareVersion": "4.7.214.0",
            "numberOfWeaknesses": 0,
            "diskPaths": [],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Microsoft Security Client"
            ],
            "softwareFirstSeenTimestamp": "2020-12-30 11:07:15",
            "endOfSupportStatus": "None",
            "endOfSupportDate": null
        },
        {
            "deviceId": "00044f68765ddaf71234bde6bd733d6a9c59ad4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18993b45912eeb224b2be2f5ea3142726e63f16a.DomainPII_21eeb80d086e79dbfa178aedfa25e8be9acfa346.corp.contoso.com",
            "osPlatform": "Windows10",
            "softwareVendor": "microsoft",
            "softwareName": "configuration_manager",
            "softwareVersion": "5.0.8634.1000",
            "numberOfWeaknesses": 0,
            "diskPaths": [],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\{B7D3A842-E826-4542-B39B-1D883264B279}"
            ],
            "softwareFirstSeenTimestamp": "2020-12-30 11:07:15",
            "endOfSupportStatus": "None",
            "endOfSupportDate": null
        },
        {
            "deviceId": "00044f38765bbaf712342dbe6db733b6a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18993b45912eeb224b2de2f5ea3142726e63f16a.DomainPII_21eeb80d086e79bdfa178eadfa25e8be9acfa346.corp.contoso.com",
            "osPlatform": "Windows10",
            "softwareVendor": "microsoft",
            "softwareName": "system_center_2012_endpoint_protection",
            "softwareVersion": "4.10.209.0",
            "numberOfWeaknesses": 0,
            "diskPaths": [],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Microsoft Security Client"
            ],
            "softwareFirstSeenTimestamp": "2020-12-30 11:07:15",
            "endOfSupportStatus": "None",
            "endOfSupportDate": null
        }
    ],
    "@odata.nextLink": "https://api.securitycenter.microsoft.com/api/machines/SoftwareInventoryByMachine?pagesize=5&$skiptoken=eyJFeHBvcnREZWZpbml0aW9uIjp7IlRpbWVQYXRoIjoiMjAyMS0wMS0yNS8wMjAwLyJ9LCJFeHBvcnRGaWxlSW5kZXgiOjAsIkxpbmVTdG9wcGVkQXQiOjV9"
}

2. Exporter l’évaluation de l’inventaire logiciel (via des fichiers)2. Export software inventory assessment (via files)

Description de la méthode api 2.12.1 API method description

Cette réponse API contient toutes les données des logiciels installés par appareil.This API response contains all the data of installed software per device. Renvoie un tableau avec une entrée pour chaque combinaison unique de DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion.Returns a table with an entry for every unique combination of DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion.

2.1.1 Limitations2.1.1 Limitations

Les limites de taux pour cette API sont de 5 appels par minute et de 20 appels par heure.Rate limitations for this API are 5 calls per minute and 20 calls per hour.

2.2 Autorisations2.2 Permissions

L’une des autorisations suivantes est nécessaire pour appeler cette API.One of the following permissions is required to call this API. Pour plus d’informations, notamment sur le choix des autorisations, voir Utiliser Microsoft Defender pour les API de point de terminaison pour plus d’informations.To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

Type d’autorisationPermission type AutorisationPermission Nom d’affichage de l’autorisationPermission display name
ApplicationApplication Software.Read.AllSoftware.Read.All 'Lire les informations sur les vulnérabilités de gestion des menaces et des vulnérabilités''Read Threat and Vulnerability Management vulnerability information'
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Software.ReadSoftware.Read 'Lire les informations sur les vulnérabilités de gestion des menaces et des vulnérabilités''Read Threat and Vulnerability Management vulnerability information'

2.3 URL2.3 URL

GET /api/machines/SoftwareInventoryExport

ParametersParameters

  • sasValidHours : nombre d’heures pendant qui les URL de téléchargement seront valides (maximum 24 heures)sasValidHours – The number of hours that the download URLs will be valid for (Maximum 24 hours)

2.5 Propriétés2.5 Properties

Notes

  • Les fichiers sont compressés gzip & au format Json multiligne.The files are gzip compressed & in multiline Json format.

  • Les URL de téléchargement ne sont valides que pendant 3 heures.The download URLs are only valid for 3 hours. Sinon, vous pouvez utiliser le paramètre.Otherwise you can use the parameter.

_ Pour une vitesse de téléchargement maximale de vos données, vous pouvez vous assurer que vous téléchargez à partir de la même région Azure que vos données résident._ For maximum download speed of your data, you can make sure you are downloading from the same Azure region that your data resides.

Propriété (ID)Property (ID) Type de donnéesData type DescriptionDescription Exemple de valeur renvoyéeExample of a returned value
Exporter des fichiersExport files chaîne de [ tableau]array[string] Liste des URL de téléchargement pour les fichiers qui contiennent la capture instantanée actuelle de l’organisationA list of download URLs for files holding the current snapshot of the organization [ Https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...1”, “https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...2” ][ Https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...1”, “https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...2” ]
GeneratedTimeGeneratedTime stringstring Heure de la générer.The time that the export was generated. 2021-05-20T08:00:00Z ]2021-05-20T08:00:00Z ]

2.6 Exemples2.6 Examples

2.6.1 Exemple de requête2.6.1 Request example

GET https://api.securitycenter.microsoft.com/api/machines/SoftwareInventoryExport

2.6.2 Exemple de réponse2.6.2 Response example

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.ExportFilesResponse",
    "exportFiles": [
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/SoftwareInventory/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00393-e423630d-4c69-4490-8769-a4f5468c4f25.c000.json.gz?sv=2019-12-12&st=2021-01-11T11%3A55%3A51Z&se=2021-01-11T14%3A55%3A51Z&sr=b&sp=r&sig=...",
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/SoftwareInventory/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00394-e423630d-4c69-4490-8769-a4f5468c4f25.c000.json.gz?sv=2019-12-12&st=2021-01-11T11%3A55%3A51Z&se=2021-01-11T14%3A55%3A51Z&sr=b&sp=r&sig=...",
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/SoftwareInventory/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00394-e423630d-4c69-4490-8769-a4f5468c4f25.c001.json.gz?sv=2019-12-12&st=2021-01-11T11%3A55%3A51Z&se=2021-01-11T14%3A55%3A51Z&sr=b&sp=r&sig=..."
    ],
    "generatedTime": "2021-01-11T11:01:00Z"
}

Voir aussiSee also

Autres associésOther related