type de ressource de capteur

Article
11/05/2024

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 .

Représente un capteur Microsoft Defender pour Identity.

Hérite de l’entité.

Méthodes

Méthode	Type de retour	Description
List	collection microsoft.graph.security.sensor	Obtenez la liste des objets de capteur et leurs propriétés.
Obtenir	microsoft.graph.security.sensor	Lire les propriétés et les relations d’un objet capteur .
Mettre à jour	microsoft.graph.security.sensor	Mettez à jour les propriétés d’un objet capteur .
Supprimer	Aucun	Supprimer un objet de capteur .
Obtenir la clé d’accès au déploiement	microsoft.graph.security.deploymentAccessKeyType	Obtenez la clé d’accès de déploiement associée à l’espace de travail Microsoft Defender pour Identity, nécessaire pour installer les capteurs associés à l’espace de travail.
Obtenir l’URI du package de déploiement	microsoft.graph.security.sensorDeploymentPackage	Obtenez l’URL et la version du package de déploiement de capteur.
Régénérer la clé d’accès au déploiement	microsoft.graph.security.deploymentAccessKeyType	Générez une nouvelle clé d’accès de déploiement qui peut être utilisée pour installer les capteurs associés à l’espace de travail.

Propriétés

Propriété	Type	Description
createdDateTime	DateTimeOffset	Date et heure de génération du capteur. L’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : `2014-01-01T00:00:00Z`.
deploymentStatus	microsoft.graph.security.deploymentStatus	Le status de déploiement du capteur. Les valeurs possibles sont `upToDate`, `outdated`, `updating`, `updateFailed`, `notConfigured`, `unreachable`, `disconnected`, `startFailure`, `syncing`, `unknownFutureValue`.
displayName	String	Nom complet du capteur.
domainName	String	Nom de domaine complet du capteur.
healthStatus	microsoft.graph.security.sensorHealthStatus	Status d’intégrité du capteur. Les valeurs possibles sont : `healthy`, `notHealthyLow`, `notHealthyMedium`, `notHealthyHigh`, `unknownFutureValue`.
id	String	Identificateur unique pour représenter le capteur. Hérité de l’entité.
openHealthIssuesCount	Int64	Ce champ affiche le nombre de problèmes d’intégrité liés à ce capteur.
sensorType	microsoft.graph.security.sensorType	Type du capteur. Les valeurs possibles sont `adConnectIntegrated`, `adcsIntegrated`, `adfsIntegrated`, `domainControllerIntegrated`, `domainControllerStandalone`, `unknownFutureValue`.
paramètres	microsoft.graph.security.sensorSettings	Informations sur les paramètres du capteur.
version	String	Version du capteur.

Valeurs deploymentStatus

Member	Description
upToDate	Le capteur exécute une version actuelle du capteur.
suranné	Sensor exécute une version du logiciel qui se trouve au moins trois versions derrière la version actuelle.
actualisation	Le logiciel de capteur est en cours de mise à jour.
updateFailed	La mise à jour du capteur vers une nouvelle version n’a pas pu être mise à jour.
notConfigured	Le capteur nécessite davantage de configuration avant d’être entièrement opérationnel. Cela s’applique aux capteurs installés sur les serveurs ADFS et ADCS ou les capteurs autonomes.
inaccessible	Le contrôleur de domaine a été supprimé d’Active Directory. Toutefois, l’installation du capteur n’a pas été désinstallée et supprimée du contrôleur de domaine avant sa mise hors service. Vous pouvez supprimer cette entrée en toute sécurité.
coupé	Le service Defender pour Identity n’a pas vu de communication à partir de ce capteur depuis 10 minutes.
startFailure	Le capteur n’a pas extrait la configuration pendant plus de 30 minutes.
Synchronisation	Le capteur a des mises à jour de configuration en attente, mais il n’a pas encore extrait la nouvelle configuration.
unknownFutureValue	Valeur sentinel de l’énumération évolutive. Ne pas utiliser.

valeurs sensorHealthStatus

Member	Description
sain	Aucun problème d’intégrité ouvert.
notHealthyLow	Le problème d’intégrité ouvert de gravité la plus élevée est faible.
notHealthyMedium	Le problème d’intégrité ouvert de gravité la plus élevée est moyen.
notHealthyHigh	Le problème d’intégrité ouvert de gravité la plus élevée est élevé.
unknownFutureValue	Valeur sentinel de l’énumération évolutive. Ne pas utiliser.

Valeurs sensorType

Member	Description
adConnectIntegrated	Capteur Entra Connect.
adcsIntegrated	Capteur ADCS (Active Directory Certificate Services).
adfsIntegrated	capteur Services ADFS (ADFS).
domainControllerIntegrated	Capteur de contrôleur de domaine.
domainControllerStandalone	Capteur autonome.
unknownFutureValue	Valeur sentinel de l’énumération évolutive. Ne pas utiliser.

Relations

Relation	Type	Description
healthIssues	collection microsoft.graph.security.healthIssue	Représente les problèmes potentiels au sein de la configuration Microsoft Defender pour Identity d’un client qui Microsoft Defender pour Identity identifiés liés au capteur.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@odata.type": "#microsoft.graph.security.sensor",
  "createdDateTime": "String (timestamp)",
  "deploymentStatus": "String",
  "displayName": "String",
  "domainName": "String",
  "healthStatus": "String",
  "id": "String (identifier)",
  "openHealthIssuesCount": "Int64",
  "sensorType": "String",
  "settings": {"@odata.type": "microsoft.graph.security.sensorSettings"},
  "version": "String"
}

Partager via