传感器资源类型

命名空间:microsoft.graph.security

表示Microsoft Defender for Identity传感器。

继承自 entity

Methods

方法 返回类型 Description
List microsoft.graph.security.sensor 集合 获取 传感器 对象及其属性的列表。
Get microsoft.graph.security.sensor 读取 传感器 对象的属性和关系。
更新 microsoft.graph.security.sensor 更新 传感器 对象的属性。
删除 None 删除 传感器 对象。
获取部署访问密钥 microsoft.graph.security.deploymentAccessKeyType 获取安装与工作区关联的传感器所需的Microsoft Defender for Identity的部署访问密钥。
获取部署包 URI microsoft.graph.security.sensorDeploymentPackage 获取 传感器 部署包 URL 和版本。
重新生成部署访问密钥 microsoft.graph.security.deploymentAccessKeyType 生成可用于安装与工作区关联的 传感器 的新部署访问密钥。

属性

属性 类型 说明
createdDateTime DateTimeOffset 生成传感器的日期和时间。 时间戳使用 ISO 8601 格式表示日期和时间信息,并且始终采用 UTC 格式。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
deploymentStatus microsoft.graph.security.deploymentStatus 传感器的部署状态。 可取值包括:upToDateoutdatedupdatingupdateFailednotConfiguredunreachabledisconnectedstartFailuresyncingunknownFutureValue
displayName String 传感器的显示名称。
domainName String 传感器的完全限定域名。
healthStatus microsoft.graph.security.sensorHealthStatus 传感器的运行状况。 可能的值包括 healthynotHealthyLownotHealthyMediumnotHealthyHighunknownFutureValue
id String 用于表示传感器的唯一标识符。 继承自 entity
openHealthIssuesCount Int64 此字段显示与此传感器相关的运行状况问题计数。
sensorType microsoft.graph.security.sensorType 传感器的类型。 可能的值包括 adConnectIntegratedadcsIntegratedadfsIntegrateddomainControllerIntegrateddomainControllerStandaloneunknownFutureValue
settings microsoft.graph.security.sensorSettings 传感器设置信息。
version String 传感器的版本。

deploymentStatus 值

成员 说明
upToDate 传感器正在运行当前版本的传感器。
过时的 Sensor 正在运行的软件版本至少落后当前版本三个版本。
更新 传感器软件正在更新中。
updateFailed 传感器无法更新到新版本。
notConfigured 传感器在完全运行之前需要进行更多配置。 这适用于安装在 ADFS 和 ADCS 服务器或独立传感器上的传感器。
遥 不可 及 域控制器已从 Active Directory 中删除。 但是,在解除授权之前,传感器安装未卸载并从域控制器中删除。 可以安全地删除此项。
断开 Defender for Identity 服务在 10 分钟内未看到来自此传感器的任何通信。
startFailure 传感器未拉取配置超过 30 分钟。
同步 Sensor 具有挂起的配置更新,但它尚未拉取新配置。
unknownFutureValue 可演变枚举 sentinel 值。 请勿使用。

sensorHealthStatus 值

成员 说明
健康 没有打开的运行状况问题。
notHealthyLow 打开的运行状况问题的最高严重性较低。
notHealthyMedium 打开的运行状况问题的最高严重性为中等。
notHealthyHigh 打开的运行状况问题的严重性最高。
unknownFutureValue 可演变枚举 sentinel 值。 请勿使用。

sensorType 值

成员 说明
adConnectIntegrated Entra Connect 传感器。
adcsIntegrated Active Directory 证书服务 (ADCS) 传感器。
adfsIntegrated Active Directory 联合身份验证服务 (ADFS) 传感器。
domainControllerIntegrated 域控制器传感器。
domainControllerStandalone 独立传感器。
unknownFutureValue 可演变枚举 sentinel 值。 请勿使用。

关系

关系 类型 说明
healthIssues microsoft.graph.security.healthIssue 集合 表示客户Microsoft Defender for Identity配置中的潜在问题,Microsoft Defender for Identity识别到与传感器相关的问题。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "@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"
}