Exportar informe de estado del antivirus del dispositivo

Artículo
06/26/2024

Se aplica a:

¿Quiere experimentar Microsoft Defender para punto de conexión? Regístrese para obtener una prueba gratuita.

Nota:

Si es un cliente del Gobierno de EE. UU., use los URI que aparecen en Microsoft Defender para punto de conexión para clientes del Gobierno de EE. UU.

Sugerencia

Para mejorar el rendimiento, puede usar el servidor más cercano a la ubicación geográfica:

us.api.security.microsoft.com
eu.api.security.microsoft.com
uk.api.security.microsoft.com
au.api.security.microsoft.com
swa.api.security.microsoft.com
ina.api.security.microsoft.com

Importante

Parte de la información contenida en este artículo se refiere a un producto preliminar que puede sufrir modificaciones sustanciales antes de su lanzamiento comercial. Microsoft no otorga garantías, expresas o implícitas, con respecto a la información que aquí se proporciona.

Esta API tiene dos métodos para recuperar los detalles de estado del antivirus del dispositivo Antivirus de Microsoft Defender:

Método uno:1 Exportar informes de estado (respuesta JSON) El método extrae todos los datos de la organización como respuestas JSON. Este método es mejor para organizaciones pequeñas con menos de 100 K dispositivos. La respuesta está paginada, por lo que puede usar el campo @odata.nextLink de la respuesta para capturar los resultados siguientes.
Método dos:2 Exportar informes de estado (a través de archivos) Este método permite extraer grandes cantidades de datos de forma más rápida y confiable. Por lo tanto, se recomienda para organizaciones grandes, con más de 100 K dispositivos. Esta API extrae todos los datos de la organización como archivos de descarga. La respuesta contiene direcciones URL para descargar todos los datos de Azure Storage. Esta API le permite descargar todos los datos de Azure Storage de la siguiente manera:
- Llame a la API para obtener una lista de direcciones URL de descarga con todos los datos de la organización.
- Descargue todos los archivos mediante las direcciones URL de descarga y procese los datos como desee.

Los datos recopilados mediante "respuesta JSON o a través de archivos" son la instantánea actual del estado actual. No contiene datos históricos. Para recopilar datos históricos, los clientes deben guardar los datos en sus propios almacenamientos de datos. Consulte Exportación de propiedades y métodos de API de detalles de estado del dispositivo.

Importante

Para que Windows Server 2012 R2 y Windows Server 2016 aparezcan en los informes de estado del dispositivo, estos dispositivos deben incorporarse mediante el paquete de solución unificado moderno. Para obtener más información, consulta Nueva funcionalidad en la solución unificada moderna para Windows Server 2012 R2 y 2016.

Nota:

Para obtener información sobre el uso de la herramienta de informes de cumplimiento antivirus y estado del dispositivo en el portal de Microsoft Defender, consulte: Informe de cumplimiento del estado del dispositivo y antivirus en Microsoft Defender para punto de conexión.

1 Exportación de informes de estado (respuesta JSON)

Descripción del método de API 1.1

Esta API recupera una lista de detalles de estado del antivirus del dispositivo Antivirus de Microsoft Defender. Devuelve una tabla con una entrada para cada combinación única de:

DeviceId
Nombre del dispositivo
Modo AV
Estado actualizado
Resultados del examen.

1.1.1 Limitaciones

El tamaño máximo de página es de 200 000
Las limitaciones de velocidad de esta API son 30 llamadas por minuto y 1000 llamadas por hora.

Operadores compatibles con OData

$filteron: machineId, computerDnsName, , osKind, osPlatform, osVersion, avMode, avEngineVersionavSignatureVersion, , avPlatformVersion, quickScanResult, , quickScanError, fullScanResultfullScanError, avIsSignatureUpToDate, avIsEngineUpToDate, , , avIsPlatformUpToDaterbacGroupId
$top con un valor máximo de 10 000.
$skip

Importante

Tenga en cuenta que rbacgroupname e Id no son operadores de filtro admitidos.

1.2 Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, consulte Uso de Las API de Microsoft Defender para punto de conexión para obtener más información.

Tipo de permiso	Permiso	Nombre para mostrar del permiso
Aplicación	Machine.Read.All	"Leer todos los perfiles de máquina"
Delegado (cuenta profesional o educativa)	Machine.Read	"Leer información de la máquina"

1.3 URL (solicitud HTTP)

URL: GET: /api/deviceavinfo

1.3.1 Encabezados de solicitud

Nombre	Tipo	Descripción
Authorization	Cadena	{token} de portador. Obligatorio.

1.3.2 Cuerpo de la solicitud

En blanco

1.3.3 Respuesta

Si se ejecuta correctamente, este método devuelve 200 OK con una lista de detalles de estado del dispositivo.

1.4 Parámetros

El tamaño de página predeterminado es 20
Consulte ejemplos en consultas de OData con Microsoft Defender para punto de conexión.

1.5 Propiedades

Consulte: 1.3 Exportación de propiedades de API de detalles de estado del antivirus de dispositivo (respuesta JSON)

Admite consultas OData V4.

Ejemplo 1.6

Ejemplo de solicitud

Esta es una solicitud de ejemplo:

GET https://api.securitycenter.microsoft.com/api/deviceavinfo

Ejemplo de respuesta

Esta es una respuesta de ejemplo:

{

    @odata.context: "https://api.securitycenter.microsoft.com/api/$metadata#DeviceAvInfo",

"value": [{

            "id": "Sample Guid",

            "machineId": "Sample Machine Guid",

            "computerDnsName": "appblockstg1",

            "osKind": "windows",

            "osPlatform": "Windows10",

            "osVersion": "10.0.19044.1865",

            "avMode": "0",

            "avSignatureVersion": "1.371.1279.0",

            "avEngineVersion": "1.1.19428.0",

            "avPlatformVersion": "4.18.2206.108",

            "lastSeenTime": "2022-08-02T19:40:45Z",

            "quickScanResult": "Completed",

            "quickScanError": "",

            "quickScanTime": "2022-08-02T18:40:15.882Z",

            "fullScanResult": "",

            "fullScanError": "",

            "fullScanTime": null,

            "dataRefreshTimestamp": "2022-08-02T21:16:23Z",

            "avEngineUpdateTime": "2022-08-02T00:03:39Z",

            "avSignatureUpdateTime": "2022-08-02T00:03:39Z",

            "avPlatformUpdateTime": "2022-06-20T16:59:35Z",

            "avIsSignatureUpToDate": "True",

            "avIsEngineUpToDate": "True",

            "avIsPlatformUpToDate": "True",

            "avSignaturePublishTime": "2022-08-02T00:03:39Z",

            "rbacGroupName": "TVM1",

            "rbacGroupId": 4415

        },

        ...

     ]

}

2 Exportar informes de estado (a través de archivos)

Importante

La información de esta sección se refiere al producto preliminar que se puede modificar sustancialmente antes de su lanzamiento comercial. Microsoft no otorga garantías, expresas o implícitas, con respecto a la información que aquí se proporciona.

2.1 Descripción del método de API

Esta respuesta de API contiene todos los datos de estado y estado del Antivirus por dispositivo. Devuelve una tabla con una entrada para cada combinación única de:

DeviceId
nombre de dispositivo
Modo AV
Estado actualizado
Resultados del examen.

2.1.2 Limitaciones

El tamaño máximo de página es de 200 000.
Las limitaciones de velocidad de esta API son 30 llamadas por minuto y 1000 llamadas por hora.

2.2 Permisos

Se requiere uno de los siguientes permisos para llamar a esta API.

Tipo de permiso	Permiso	Nombre para mostrar del permiso
Aplicación	Vulnerability.Read.All	"Leer información sobre vulnerabilidades de administración de amenazas y vulnerabilidades"
Delegado (cuenta profesional o educativa)	Vulnerability.Read	"Leer información sobre vulnerabilidades de administración de amenazas y vulnerabilidades"

Para obtener más información, incluido cómo elegir permisos, consulte Uso de Las API de Microsoft Defender para punto de conexión para obtener más información.

Dirección URL 2.3

GET /api/machines/InfoGatheringExport

2.4 Parámetros

sasValidHours: el número de horas para las que serán válidas las direcciones URL de descarga (máximo 24 horas).

2.5 Propiedades

Consulte: 1.4 Export device antivirus health details API properties (via files).

2.6 Ejemplos

2.6.1 Ejemplo de solicitud

Esta es una solicitud de ejemplo:

GET https://api-us.securitycenter.contoso.com/api/machines/InfoGatheringExport

Ejemplo de respuesta 2.6.2

Esta es una respuesta de ejemplo:

{

   "@odata.context": "https://api-us.securitycenter.windows.com/api/$metadata#microsoft.windowsDefenderATP.api.ExportFilesResponse",

   "exportFiles": [

       "https://tvmexportexternalprdeus.blob.core.windows.net/temp-../2022-08-02/2201/InfoGatheringExport/json/OrgId=../_RbacGroupId=../part-00055-12fc2fcd-8f56-4e09-934f-e8efe7ce74a0.c000.json.gz?sv=2020-08-04&st=2022-08-02T22%3A47%3A11Z&se=2022-08-03T01%3A47%3A11Z&sr=b&sp=r&sig=..",

       "https://tvmexportexternalprdeus.blob.core.windows.net/temp-../2022-08-02/2201/InfoGatheringExport/json/OrgId=../_RbacGroupId=../part-00055-12fc2fcd-8f56-4e09-934f-e8efe7ce74a0.c000.json.gz?sv=2020-08-04&st=2022-08-02T22%3A47%3A11Z&se=2022-08-03T01%3A47%3A11Z&sr=b&sp=r&sig=.."

   ],


   "generatedTime": "2022-08-02T22:01:00Z"


}

Sugerencia

Sugerencia de rendimiento Debido a una variedad de factores (ejemplos que se enumeran a continuación) Antivirus de Microsoft Defender, como otro software antivirus, puede causar problemas de rendimiento en los dispositivos de punto de conexión. En algunos casos, es posible que tenga que ajustar el rendimiento del Antivirus de Microsoft Defender para aliviar esos problemas de rendimiento. El analizador de rendimiento de Microsoft es una herramienta de línea de comandos de PowerShell que ayuda a determinar qué archivos, rutas de acceso de archivo, procesos y extensiones de archivo podrían estar causando problemas de rendimiento; Algunos ejemplos son:

Rutas de acceso principales que afectan al tiempo de examen
Archivos principales que afectan al tiempo de examen
Principales procesos que afectan al tiempo de examen
Extensiones de archivo principales que afectan al tiempo de examen
Combinaciones: por ejemplo:
- archivos principales por extensión
- rutas de acceso superiores por extensión
- procesos principales por ruta de acceso
- exámenes superiores por archivo
- exámenes superiores por archivo por proceso

Puede usar la información recopilada mediante el Analizador de rendimiento para evaluar mejor los problemas de rendimiento y aplicar acciones de corrección. Consulte: Analizador de rendimiento para antivirus de Microsoft Defender.

Vea también

Exportar las propiedades y los métodos de estado del dispositivo

Informes de cumplimiento y estado del dispositivo

Sugerencia

¿Desea obtener más información? Interactúe con la comunidad de seguridad de Microsoft en nuestra comunidad tecnológica: Microsoft Defender para punto de conexión Tech Community.

Compartir vía

Exportar informe de estado del antivirus del dispositivo

1 Exportación de informes de estado (respuesta JSON)

Descripción del método de API 1.1

1.1.1 Limitaciones

Operadores compatibles con OData

1.2 Permisos

1.3 URL (solicitud HTTP)

1.3.1 Encabezados de solicitud

1.3.2 Cuerpo de la solicitud

1.3.3 Respuesta

1.4 Parámetros

1.5 Propiedades

Ejemplo 1.6

Ejemplo de solicitud

Ejemplo de respuesta

2 Exportar informes de estado (a través de archivos)

2.1 Descripción del método de API

2.1.2 Limitaciones

2.2 Permisos

Dirección URL 2.3

2.4 Parámetros

2.5 Propiedades

2.6 Ejemplos

2.6.1 Ejemplo de solicitud

Ejemplo de respuesta 2.6.2

Vea también

Comentarios

Recursos adicionales