Obter software instalado

Importante

Algumas informações neste artigo estão relacionadas com um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não concede garantias, expressas ou implícitas, relativamente às informações aqui fornecidas.

Obtém uma coleção de software instalado relacionado com um determinado ID de dispositivo.

Permissões

É necessária uma das seguintes permissões para chamar esta API. Para saber mais, incluindo como escolher permissões, veja Utilizar Microsoft Defender para Endpoint APIs

Tipo de permissão	Permissão	Nome a apresentar da permissão
Aplicação	Software.Read.All	"Ler informações do Software de Gestão de Ameaças e Vulnerabilidades"
Delegado (conta escolar ou profissional)	Software.Read	"Ler informações do Software de Gestão de Ameaças e Vulnerabilidades"

Pedido HTTP

GET /api/machines/{machineId}/software

Cabeçalhos de pedido

Name	Tipo	Descrição
Autorização	Cadeia	Portador {token}. Obrigatório.

Corpo do pedido

Vazio

Resposta

Se for bem-sucedido, este método devolve 200 OK com as informações de software instaladas no corpo.

Exemplos:

Exemplo de pedido

Eis um exemplo do pedido.

GET https://api.security.microsoft.com/api/machines/ac233fa6208e1579620bf44207c4006ed7cc4501/software

Exemplo de resposta

Eis um exemplo da resposta.

{
"@odata.context": "https://api.security.microsoft.com/api/$metadata#Software",
"value": [
        {
"id": "microsoft-_-internet_explorer",
"name": "internet_explorer",
"vendor": "microsoft",
"weaknesses": 67,
"publicExploit": true,
"activeAlert": false,
"exposedMachines": 42115,
"impactScore": 46.2037163
        }
    ]
}