Ler em inglês

Compartilhar via


Tipo de recurso do computador

Aplica-se a:

Deseja experimentar o Microsoft Defender para Ponto de Extremidade? Inscreva-se para uma avaliação gratuita.

Observação

Se for um cliente do Us Government, utilize os URIs listados no Microsoft Defender para Endpoint para clientes do Us Government.

Dica

Para um melhor desempenho, pode utilizar o servidor mais próximo da localização 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

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

Métodos

Método Tipo de retorno Descrição
Listar computadores coleção de máquinas Listar o conjunto de entidades de máquinas na organização.
Obter computador computador Obtenha uma máquina pela respetiva identidade.
Obter sessão iniciada de utilizadores Coleção user Obtenha o conjunto de Utilizador que iniciou sessão no computador.
Obter alertas relacionados conjunto alerta Obtenha o conjunto de entidades de alerta que foram criadas no computador.
Obter o software instalado coleção de software Obtém uma coleção de software instalado relacionado com um determinado ID de computador.
Obter vulnerabilidades descobertas coleção de vulnerabilidades Obtém uma coleção de vulnerabilidades detetadas relacionadas com um determinado ID de computador.
Obter recomendações de segurança coleção de recomendações Obtém uma coleção de recomendações de segurança relacionadas com um determinado ID de computador.
Adicionar ou Remover marcas de computador computador Adicionar ou Remover etiqueta a um computador específico.
Localizar os computadores por IP coleção de máquinas Localizar computadores vistos com IP.
Localizar os computadores por marca coleção de máquinas Localizar máquinas por Etiqueta.
Obter KBs ausentes Coleção KB Obter uma lista de KBs em falta associados ao ID do computador
Definir valor do dispositivo coleção de máquinas Defina o valor de um dispositivo.
Atualizar computador coleção de máquinas Obtenha o estado de atualização de um computador.

Propriedades

Propriedade Tipo Descrição
id Cadeia de caracteres identidade do computador.
computerDnsName Cadeia de caracteres nome completamente qualificado do computador.
firstSeen DateTimeOffset Primeira data e hora em que o computador foi observado pelo Microsoft Defender para Endpoint.
lastSeen DateTimeOffset Hora e data do último relatório completo do dispositivo recebido. Normalmente, um dispositivo envia um relatório completo a cada 24 horas.
NOTA: esta propriedade não corresponde ao último valor visto na IU. Diz respeito à última atualização do dispositivo.
osPlatform Cadeia de caracteres Plataforma do sistema operativo.
onboardingstatus Cadeia de caracteres Estado da integração da máquina. Os valores possíveis são: onboarded, CanBeOnboarded, Unsupported, e InsufficientInfo.
osProcessor Cadeia de caracteres Processador do sistema operativo. Em alternativa, utilize a propriedade osArchitecture.
versão Cadeia de caracteres Versão do sistema operativo.
osBuild Anulável longo Número de compilação do sistema operativo.
lastIpAddress Cadeia de caracteres Último IP na NIC local no computador.
lastExternalIpAddress Cadeia de caracteres Último IP através do qual o computador acedeu à Internet.
healthStatus Enum estado de funcionamento do computador. Os valores possíveis são: Active, , InactiveImpairedCommunication, NoSensorData, , NoSensorDataImpairedCommunicatione Unknown.
rbacGroupName Cadeia de caracteres Nome do grupo de máquinas.
rbacGroupId Cadeia de caracteres ID do grupo de máquinas.
riskScore Enumeração Anulável Pontuação de risco, conforme avaliado pelo Microsoft Defender para Endpoint. Os valores possíveis são: None, , InformationalLow, , Mediume High.
aadDeviceId Guid de representação anulável ID do Dispositivo do Microsoft Entra (quando o computador está associado ao Microsoft Entra).
machineTags String collection Conjunto de etiquetas de máquina .
exposureLevel Enumeração Anulável Nível de exposição, conforme avaliado pelo Microsoft Defender para Endpoint. Os valores possíveis são: None, Low, Medium, e High.
deviceValue Enumeração Anulável O valor do dispositivo. Os valores possíveis são: Normal, Lowe High.
ipAddresses Coleção ipAddress Conjunto de objetos IpAddress . Veja Obter API de máquinas virtuais.
osArchitecture Cadeia de caracteres Arquitetura do sistema operativo. Os valores possíveis são: 32-bit e 64-bit. Utilize esta propriedade em vez de osProcessor.

Dica

Você deseja aprender mais? Contacte a comunidade de Segurança da Microsoft na nossa Comunidade Tecnológica: Microsoft Defender para Endpoint Tech Community.