Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 de sensor . |
| Actualizar | microsoft.graph.security.sensor | Actualice las propiedades de un objeto de sensor . |
| Delete | Ninguno | Eliminar un objeto de sensor . |
| Obtención de la 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 los sensores asociados al área de trabajo. |
| Obtención del URI del paquete de implementación | microsoft.graph.security.sensorDeploymentPackage | Obtenga la dirección URL y la versión del paquete de implementación del sensor. |
| Regeneración de la clave de acceso de implementación | microsoft.graph.security.deploymentAccessKeyType | Genere una nueva clave de acceso de implementación que se pueda usar para instalar sensores asociados al área de trabajo. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| createdDateTime | DateTimeOffset | Fecha y hora en que se generó el sensor. La marca de tiempo representa la información de fecha y hora con 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 | Estado de implementación del sensor. Los valores posibles son: upToDate, outdated, updating, updateFailed, notConfigured, unreachable, disconnected, startFailure, syncing y unknownFutureValue. |
| displayName | Cadena | Nombre para mostrar del sensor. |
| domainName | Cadena | 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. |
| openHealthIssuesCount | Int64 | Este campo muestra el recuento de problemas de mantenimiento relacionados con este sensor. |
| sensorType | microsoft.graph.security.sensorType | Tipo del sensor. Los valores posibles son: adConnectIntegrated, adcsIntegrated, adfsIntegrated, domainControllerIntegrated, domainControllerStandalone, unknownFutureValue. |
| serviceStatus | microsoft.graph.security.serviceStatus | 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. |
valores deploymentStatus
| Member | Descripción |
|---|---|
| upToDate | El sensor está ejecutando una versión actual del sensor. |
| anticuado | El sensor está ejecutando una versión del software que es al menos tres versiones detrás de la versión actual. |
| actualización | Se está actualizando el software del sensor. |
| updateFailed | No se pudo actualizar el sensor a una nueva versión. |
| notConfigured | El sensor requiere más configuración antes de que esté totalmente 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 ha desinstalado y quitado 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 desde este sensor en 10 minutos. |
| startFailure | El sensor no extraía la configuración durante más de 30 minutos. |
| Sincronización | El sensor tiene actualizaciones de configuración pendientes, pero aún no ha quitado la nueva configuración. |
| unknownFutureValue | Valor de sentinel de enumeración evolvable. No usar. |
valores sensorHealthStatus
| Member | Descripción |
|---|---|
| sano | No hay problemas de mantenimiento abiertos. |
| notHealthyLow | El problema de estado abierto de gravedad más alta es bajo. |
| notHealthyMedium | El problema de estado abierto de gravedad más alta es medio. |
| notHealthyHigh | El problema de estado abierto de gravedad más alta es alto. |
| unknownFutureValue | Valor de sentinel de enumeración evolvable. No usar. |
valores sensorType
| Member | Descripción |
|---|---|
| adConnectIntegrated | Sensor Entra Connect. |
| adcsIntegrated | Sensor de Servicios de certificados de Active Directory (ADCS). |
| adfsIntegrated | Servicios de federación de Active Directory (AD FS) (ADFS). |
| domainControllerIntegrated | Sensor de controlador de dominio. |
| domainControllerStandalone | Sensor independiente. |
| unknownFutureValue | Valor de sentinel de enumeración evolvable. 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 identificar relacionada 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)",
"openHealthIssuesCount": "Int64",
"sensorType": "String",
"settings": {"@odata.type": "microsoft.graph.security.sensorSettings"},
"version": "String",
"serviceStatus": "String"
}