Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms : microsoft.graph.security
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Un appareil signalé dans l’alerte.
Hérite d’alertEvidence.
Propriétés
| Propriété | Type | Description |
|---|---|---|
| azureAdDeviceId | String | Identificateur unique attribué à un appareil par Microsoft Entra ID lorsque l’appareil est joint à Microsoft Entra. |
| defenderAvStatus | microsoft.graph.security.defenderAvStatus | État du moteur anti-programme malveillant Defender. Les valeurs possibles sont notReporting, disabled, notUpdated, updated, unknown, notSupported, unknownFutureValue. |
| deviceDnsName | String | Le nom de domaine complet (FQDN) de l’appareil. |
| dnsDomain | String | Domaine DNS auquel cet ordinateur appartient. Séquence d’étiquettes séparées par des points. |
| firstSeenDateTime | DateTimeOffset | Date et heure auxquelles l’appareil a été vu pour la première fois. |
| healthStatus | microsoft.graph.security.deviceHealthStatus | État d’intégrité de l’appareil. Les valeurs possibles sont active, inactive, impairedCommunication, noSensorData, noSensorDataImpairedCommunication, unknown, unknownFutureValue. |
| hostName | String | Nom d’hôte sans le suffixe de domaine. |
| ipInterfaces | String collection | Interfaces IP de l’appareil pendant le temps de l’alerte. |
| loggedOnUsers | collection microsoft.graph.security.logedOnUser | Utilisateurs qui ont ouvert une session sur l’ordinateur au moment de l’alerte. |
| mdeDeviceId | String | Identificateur unique attribué à un appareil par Microsoft Defender pour point de terminaison. |
| ntDomain | String | Regroupement logique d’ordinateurs au sein d’un réseau Microsoft Windows. |
| onboardingStatus | microsoft.graph.security.onboardingStatus | Le status de l’intégration de la machine à Microsoft Defender pour point de terminaison. Les valeurs possibles sont : insufficientInfo, onboarded, canBeOnboarded, unsupported, unknownFutureValue. |
| osBuild | Int64 | Version de build du système d’exploitation exécuté par l’appareil. |
| osPlatform | String | La plateforme du système d’exploitation que l’appareil exécute. |
| rbacGroupId | Int32 | ID du groupe de dispositifs de contrôle d’accès en fonction du rôle. |
| rbacGroupName | String | Nom du groupe de dispositifs de contrôle d’accès en fonction du rôle. |
| riskScore | microsoft.graph.security.deviceRiskScore | Niveau de risque tel qu’évalué par Microsoft Defender pour point de terminaison. Les valeurs possibles sont none, informational, low, medium, high, unknownFutureValue. |
| resourceAccessEvents | microsoft.graph.security.resourceAccessEvent collection | Informations sur les tentatives d’accès aux ressources effectuées par le compte utilisateur. |
| version | String | Version de la plateforme du système d’exploitation. |
| Métadonnées de machine virtuelle | microsoft.graph.security.vmMetadata | Métadonnées de la machine virtuelle sur laquelle Microsoft Defender pour point de terminaison est en cours d’exécution. |
valeurs defenderAvStatus
| Member | Description |
|---|---|
| notReporting | Le moteur anti-programme malveillant de Defender ne signale pas. |
| désactivé | Le moteur anti-programme malveillant de Defender est désactivé. |
| notUpdated | Le moteur anti-programme malveillant de Defender n’est pas à jour. |
| Mise à jour | Le moteur anti-programme malveillant de Defender est à jour. |
| unknown | L’état du moteur anti-programme malveillant de Defender est inconnu. |
| notSupported | Le moteur anti-programme malveillant de Defender n’est pas pris en charge sur cette plateforme. |
| unknownFutureValue | unknownFutureValue pour les modèles d’énumérations évolutifs. |
valeurs deviceHealthStatus
| Member | Description |
|---|---|
| Actif | L’appareil est actif et signale à tous les canaux. |
| inactif | L’appareil ne signale à aucun canal. |
| impairedCommunication | L’appareil n’est pas connecté au CnC. |
| noSensorData | L’appareil n’envoie pas de télémétrie. |
| noSensorDataImpairedCommunication | L’appareil n’est pas connecté au CnC et n’envoie pas de télémétrie. |
| unknown | L’état de l’appareil est inconnu |
| unknownFutureValue | unknownFutureValue pour les modèles d’énumérations évolutifs. |
valeurs deviceRiskScore
| Member | Description |
|---|---|
| none | Aucune alerte n’est liée à cet appareil. |
| Éléments informatifs | L’appareil dispose uniquement d’alertes de niveau « informationnel ». |
| Faible | L’appareil dispose uniquement d’alertes « faibles » ou « informatives ». |
| medium | L’appareil a des alertes de gravité « moyenne » ou inférieure. |
| Plus élevé | L’appareil a des alertes de gravité « élevée » et est exposé. |
| unknownFutureValue | unknownFutureValue pour les modèles d’énumérations évolutifs. |
onboardingStatus values
| Member | Description |
|---|---|
| unknown | Status d’intégration inconnu |
| insufficientInfo | Le status d’intégration ne peut pas être déterminé. |
| intégrés | L’appareil est intégré au service. |
| canBeOnboarded | L’appareil peut être intégré au service. |
| Non pris en charge | L’appareil n’est pas pris en charge par le service. |
| unknownFutureValue | unknownFutureValue pour les modèles d’énumérations évolutifs. |
Relations
Aucun.
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@odata.type": "#microsoft.graph.security.deviceEvidence",
"azureAdDeviceId": "String",
"createdDateTime": "String (timestamp)",
"defenderAvStatus": "String",
"detailedRoles": ["String"],
"deviceDnsName": "String",
"dnsDomain": "String",
"firstSeenDateTime": "String (timestamp)",
"healthStatus": "String",
"hostName": "String",
"ipInterfaces": ["String"],
"loggedOnUsers": [{"@odata.type": "microsoft.graph.security.loggedOnUser"}],
"mdeDeviceId": "String",
"ntDomain": "String",
"onboardingStatus": "String",
"osBuild": "Integer",
"osPlatform": "String",
"rbacGroupId": "Integer",
"rbacGroupName": "String",
"remediationStatus": "String",
"remediationStatusDetails": "String",
"resourceAccessEvents": [
{
"@odata.type": "microsoft.graph.security.resourceAccessEvent"
}
],
"riskScore": "String",
"roles": ["String"],
"tags": ["String"],
"verdict": "String",
"version": "String",
"vmMetadata": {"@odata.type": "microsoft.graph.security.vmMetadata"}
}