userSecurityState 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

包含有关用户帐户的有状态信息。

属性

属性	类型	说明
aadUserId	String	AAD 用户对象标识符 (GUID) - 表示物理/多帐户用户实体。
accountName	String	没有 Active Directory 域 (DNS 域的用户帐户名 -) (也称为 mailNickName) 。
domainName	String	用户帐户的 NetBIOS/Active Directory (，即域\帐户格式) 。
emailRole	emailRole	对于电子邮件相关警报 - 用户帐户的电子邮件"角色"。 可取值为：unknown、sender、recipient。
isVpn	布尔	指示用户是否通过 VPN 登录。
logonDateTime	DateTimeOffset	登录发生的时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。
logonId	String	用户登录 ID。
logonIp	String	IP 地址 源自登录请求。
logonLocation	String	位置 (IP 地址映射) 与此用户登录事件关联的 IP 地址映射。
logonType	logonType	用户登录方法。 可取值为：unknown、interactive、remoteInteractive、network、batch、service。
onPremisesSecurityIdentifier	String	Active Directory (用户) SID (本地) 安全标识符。
riskScore	String	提供程序生成/计算用户帐户的风险评分。 建议的值范围为 0-1，等于百分比。
userAccountType	userAccountSecurityType	根据 Windows 定义 (组) 用户帐户类型。 可取值为：unknown、standard、power、administrator。
userPrincipalName	String	用户登录名 - Internet 格式： (用户帐户名) @ (用户帐户 DNS 域名) 。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "aadUserId": "String",
  "accountName": "String",
  "domainName": "String",
  "emailRole": "@odata.type: microsoft.graph.emailRole",
  "isVpn": true,
  "logonDateTime": "String (timestamp)",
  "logonId": "String",
  "logonIp": "String",
  "logonLocation": "String",
  "logonType": "@odata.type: microsoft.graph.logonType",
  "onPremisesSecurityIdentifier": "String",
  "riskScore": "String",
  "userAccountType": "@odata.type: microsoft.graph.userAccountSecurityType",
  "userPrincipalName": "String"
}