deviceLocalCredentialInfo を取得する
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
指定したデバイス オブジェクトの deviceLocalCredentialInfo のプロパティを取得します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
アクセス許可
この 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"
}
]
}
}