传感器资源类型
命名空间：microsoft.graph.security
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示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 | 传感器的部署状态。 可取值包括：upToDate、outdated、updating、updateFailed、notConfigured、unreachable、disconnected、startFailure、syncing、unknownFutureValue。 |
| displayName | String | 传感器的显示名称。 |
| domainName | String | 传感器的完全限定域名。 |
| healthStatus | microsoft.graph.security.sensorHealthStatus | 传感器的运行状况。 可能的值包括 healthy、notHealthyLow、notHealthyMedium、notHealthyHigh、unknownFutureValue。 |
| id | String | 用于表示传感器的唯一标识符。 继承自 entity。 |
| openHealthIssuesCount | Int64 | 此字段显示与此传感器相关的运行状况问题计数。 |
| sensorType | microsoft.graph.security.sensorType | 传感器的类型。 可能的值包括 adConnectIntegrated、adcsIntegrated、adfsIntegrated、domainControllerIntegrated、domainControllerStandalone、unknownFutureValue。 |
| 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"
}