Type de ressource de capteur

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	Obtenir une liste des objets capteur et de 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	Mettre à jour les propriétés d’un objet capteur .
Supprimer	Aucun	Supprimer un objet capteur .
Obtenir une clé d’accès au déploiement	microsoft.graph.security.deploymentAccessKeyType	Obtenez la clé d’accès au 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 capteurs.
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 au 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	L’status de déploiement du capteur. Les valeurs possibles sont upToDate, outdated, updating, updateFailed, notConfigured, unreachable, disconnected, startFailure, syncing, unknownFutureValue.
displayName	String	Nom d’affichage du capteur.
domainName	String	Nom de domaine complet du capteur.
healthStatus	microsoft.graph.security.sensorHealthStatus	L’status d’intégrité du capteur. Les valeurs possibles sont : healthy, notHealthyLow, notHealthyMedium, notHealthyHigh, unknownFutureValue.
id	String	Identifiant unique pour représenter le capteur. Hérité de l’entité.
migrationState	microsoft.graph.security.migrationState	État de migration du capteur. Les valeurs possibles sont readyForMigration, notReadyForMigration, upToDate, migrationFailed, migrating, unknownFutureValue.
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.
serviceStatus	microsoft.graph.security.serviceStatus	Le status du service. Les valeurs possibles sont stopped, starting, running, disabled, onboarding, unknown, 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.
obsolète	Sensor exécute une version du logiciel qui a au moins trois versions de retard sur la version actuelle.
Mise à jour	Le logiciel des capteurs est en cours de mise à jour.
updateFailed	Échec de la mise à jour du capteur vers une nouvelle version.
notConfigured	Le capteur nécessite plus de configuration avant d’être pleinement opérationnel. Cela s’applique aux capteurs installés sur des serveurs ADFS et ADCS ou sur des 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é.
Déconnecté	Le service Defender pour l’identité n’a vu aucune communication de ce capteur en 10 minutes.
startFailure	Le capteur n’a pas extrait la configuration pendant plus de 30 minutes.
en cours de synchronisation	Le capteur a des mises à jour de configuration en attente, mais il n’a pas encore extrait la nouvelle configuration.
unknownFutureValue	Valeur sentinelle d’é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 sentinelle d’énumération évolutive. Ne pas utiliser.

sensorType de valeurs

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

Relations

Relation	Type	Description
healthIssues	collection microsoft.graph.security.healthIssue	Représente les problèmes potentiels dans la configuration de Microsoft Defender pour Identity d’un client que Microsoft Defender pour Identity a identifiés en relation avec le 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)",
  "migrationState": "String",
  "openHealthIssuesCount": "Int64",
  "sensorType": "String",
  "settings": {"@odata.type": "microsoft.graph.security.sensorSettings"},
  "version": "String",
  "serviceStatus": "String"
}