Tipo de recurso de sensor

Espacio de nombres: microsoft.graph.security

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa un sensor de Microsoft Defender for Identity.

Hereda de la entidad.

Methods

Método Tipo devuelto Descripción
List Colección Microsoft.Graph.Security.Sensor Obtenga una lista de objetos de sensor y sus propiedades.
Get microsoft.graph.security.sensor Lea las propiedades y relaciones de un objeto sensor.
Actualizar microsoft.graph.security.sensor Actualizar las propiedades de un objeto sensor.
Delete Ninguno Eliminar un objeto de sensor .
Obtener clave de acceso de implementación microsoft.graph.security.deploymentAccessKeyType Obtenga la clave de acceso de implementación asociada al área de trabajo de Microsoft Defender for Identity, necesaria para instalar sensores asociados al área de trabajo.
Obtener el URI del paquete de implementación microsoft.graph.security.sensorDeploymentPackage Obtenga la dirección URL y la versión del paquete de implementación de sensores.
Regenerar clave de acceso de implementación microsoft.graph.security.deploymentAccessKeyType Generar una nueva clave de acceso a la implementación que se pueda usar para instalar sensores asociados al área de trabajo.

Propiedades

Propiedad Tipo Descripción
createdDateTime DateTimeOffset La fecha y hora en que se generó el sensor. La marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.
deploymentStatus microsoft.graph.security.deploymentStatus El estado de implementación del sensor. Los valores posibles son: upToDate, outdated, updating, updateFailed, notConfigured, unreachable, disconnected, startFailure, syncing y unknownFutureValue.
displayName Cadena El nombre para mostrar del sensor.
domainName Cadena El nombre de dominio completo del sensor.
healthStatus microsoft.graph.security.sensorHealthStatus Estado de mantenimiento del sensor. Los valores posibles son: healthy, notHealthyLow, notHealthyMedium, notHealthyHigh, unknownFutureValue.
id Cadena Identificador único para representar el sensor. Heredado de la entidad.
migrationState microsoft.graph.security.migrationState El estado de migración del sensor. Los valores posibles son: readyForMigration, notReadyForMigration, upToDate, migrationFailed, migrating, unknownFutureValue.
openHealthIssuesCount Int64 Este campo muestra el recuento de problemas de salud relacionados con este sensor.
sensorType microsoft.graph.security.sensorType El tipo del sensor. Los valores posibles son: adConnectIntegrated, adcsIntegrated, adfsIntegrated, domainControllerIntegrated, domainControllerStandalone, unknownFutureValue.
serviceStatus microsoft.graph.security.serviceStatus El estado del servicio. Los valores posibles son: stopped, starting, running, disabled, onboarding, unknown y unknownFutureValue.
configuración microsoft.graph.security.sensorSettings Información de configuración del sensor.
version Cadena La versión del sensor.

deploymentStatus values

Member Descripción
upToDate El sensor está ejecutando una versión actual del sensor.
obsoleto El sensor ejecuta una versión del software que está al menos tres versiones por detrás de la versión actual.
actualizando El software del sensor se está actualizando.
updateFailed El sensor no se pudo actualizar a una nueva versión.
no configurado El sensor requiere más configuración antes de que esté completamente operativo. Esto se aplica a los sensores instalados en servidores ADFS y ADCS o sensores independientes.
inalcanzable El controlador de dominio se eliminó de Active Directory. Sin embargo, la instalación del sensor no se desinstaló ni quitó del controlador de dominio antes de que se retirara. Puede eliminar esta entrada de forma segura.
Desconectado El servicio Defender for Identity no ha visto ninguna comunicación de este sensor en 10 minutos.
startFailure El sensor no extrajo la configuración durante más de 30 minutos.
Sincronizando El sensor tiene actualizaciones de configuración pendientes, pero aún no ha extraído la nueva configuración.
unknownFutureValue Valor centinela de enumeración evolutiva. No usar.

Valores de sensorHealthStatus

Member Descripción
en buen estado No hay problemas de salud abiertos.
notHealthyLow El problema de salud abierto de mayor gravedad es bajo.
notHealthyMedium El problema de salud abierto de mayor gravedad es medio.
notHealthyHigh El problema de salud abierto de mayor gravedad es alto.
unknownFutureValue Valor centinela de enumeración evolutiva. No usar.

Valores sensorType

Member Descripción
adConnectIntegrated Sensor Entra Connect.
adcsIntegrated Sensor de Servicios de certificados de Active Directory (ADCS).
adfsIntegrated sensor de Servicios de federación de Active Directory (AD FS) (ADFS).
domainControllerIntegrated Sensor de controlador de dominio.
domainControllerStandalone Sensor autónomo.
unknownFutureValue Valor centinela de enumeración evolutiva. No usar.

Relaciones

Relación Tipo Descripción
healthIssues Colección microsoft.graph.security.healthIssue Representa posibles problemas dentro de la configuración de Microsoft Defender for Identity de un cliente que Microsoft Defender for Identity identificó relacionados con el sensor.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@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"
}
  • Last updated on