通过

获取 deviceLocalCredentialInfo

  • 项目

命名空间：microsoft.graph

重要

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

检索指定设备对象的 deviceLocalCredentialInfo 的属性。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ✅ ✅ ✅

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。

权限类型 最低特权权限 更高特权权限
委派（工作或学校帐户） DeviceLocalCredential.ReadBasic.All DeviceLocalCredential.Read.All
委派（个人 Microsoft 帐户） 不支持。 不支持。
应用程序 DeviceLocalCredential.ReadBasic.All DeviceLocalCredential.Read.All

若要访问设备上的实际密码（通过包括 $select=credentials 作为查询参数的一部分完成），必须为应用分配 DeviceLocalCredential.Read.All 权限和 DeviceLocalCredential.ReadBasic.All 不够。

重要

在具有工作或学校帐户的委托方案中，必须为登录用户分配受支持的Microsoft Entra角色或具有支持的角色权限的自定义角色。 此操作支持以下最低特权角色。

  • 云设备管理员
  • 帮助台管理员
  • Intune 服务管理员
  • 安全管理员
  • 安全信息读取者
  • 全局读取者

若要使用 $select=credentials 查询参数访问设备上的实际密码，支持以下最低特权角色：

  • 云设备管理员
  • Intune 服务管理员

HTTP 请求

若要获取特定设备对象的设备本地凭据，请执行以下操作：

GET /directory/deviceLocalCredentials/{deviceId}

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
User-Agent 调用应用程序的标识符。 此值包含有关所用操作系统和浏览器的信息。 必填。
ocp-client-name 执行 API 调用的客户端应用程序的名称。 此标头用于调试目的。 可选。
ocp-client-version 执行 API 调用的客户端应用程序的版本。 此标头用于调试目的。 可选。

可选的查询参数

此方法支持 $select OData 查询参数来帮助自定义响应。 若要了解一般信息，请参阅 OData 查询参数。

请求正文

请勿提供此方法的请求正文。

响应

如果成功，此方法在 200 OK 响应正文中返回响应代码和 deviceLocalCredential 对象。

示例

示例 1：获取设备的本地管理员帐户凭据信息

请求

以下示例显示了一个请求。 此示例不返回 credentials 属性。

GET https://graph.microsoft.com/beta/directory/deviceLocalCredentials/b465e4e8-e4e8-b465-e8e4-65b4e8e465b4
User-Agent: "Dsreg/10.0 (Windows 10.0.19043.1466)"
ocp-client-name: "My Friendly Client"
ocp-client-version: "1.2"

响应

以下示例显示了相应的响应。

注意：为了提高可读性，可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": {
    "@odata.type": "#microsoft.graph.deviceLocalCredentialInfo",
    "id": "b465e4e8-e4e8-b465-e8e4-65b4e8e465b4",
    "deviceName": "LAPS_TEST",
    "lastBackupDateTime": "2023-04-21T13:45:30.0000000Z",
    "refreshDateTime": "2020-05-20T13:45:30.0000000Z"
  }
}

示例 2：使用 credentials 属性获取设备本地管理员帐户 凭据 信息

请求

以下示例显示了一个请求。

GET https://graph.microsoft.com/beta/directory/deviceLocalCredentials/b465e4e8-e4e8-b465-e8e4-65b4e8e465b4?$select=credentials
User-Agent: "Dsreg/10.0 (Windows 10.0.19043.1466)"
ocp-client-name: "My Friendly Client"
ocp-client-version: "1.2"

响应

以下示例显示了相应的响应。

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": {
    "@odata.type": "#microsoft.graph.deviceLocalCredentialInfo",
    "id": "b465e4e8-e4e8-b465-e8e4-65b4e8e465b4",
    "deviceName": "LAPS_TEST",
    "lastBackupDateTime": "2023-04-21T13:45:30.0000000Z",
    "refreshDateTime": "2020-05-20T13:45:30.0000000Z",
    "credentials": [
      {
        "accountName": "ContosoLocalAdminAccount",
        "accountSid": "S-1-5-21-2318549658-1590267884-3984890135-1965",
        "backupDateTime": "2023-04-21T13:45:30.0000000Z",
        "passwordBase64": "UQBRAEAAZAA4AGYAOABnAFkA"
      },
      {
        "accountName": "ContosoLocalAdminAccount",
        "accountSid": "S-1-5-21-2318549658-1590267884-3984890135-1965",
        "backupDateTime": "2023-03-22T13:45:30.0000000Z",
        "passwordBase64": "KgBEADkAawBsAGsAZgAjADQA"
      },
      {
        "accountName": "Administrator",
        "accountSid": "S-1-5-21-2318549658-1590267884-3984890135-500",
        "backupDateTime": "2023-02-23T13:45:30.0000000Z",
        "passwordBase64": "TABwAGQAOQAqACgAKQAzADQA"
      }
    ]
  }
}