Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Important: Microsoft prend en charge les API Intune /beta, mais elles sont sujettes à des modifications plus fréquentes. Microsoft recommande d’utiliser la version v1.0 si possible. Vérifiez la disponibilité d’une API dans la version v1.0 à l’aide du sélecteur de version.
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
Mettez à jour les propriétés d’un objet mobileAppIntentAndState .
Cette API est disponible dans les déploiements de cloud national suivants.
| Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Autorisations
L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.
| Type d’autorisation | Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins) |
|---|---|
| Déléguée (compte professionnel ou scolaire) | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. |
| Application | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All |
Requête HTTP
PATCH /users/{usersId}/mobileAppIntentAndStates/{mobileAppIntentAndStateId}
En-têtes de demande
| En-tête | Valeur |
|---|---|
| Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
| Accepter | application/json |
Corps de la demande
Dans le corps de la demande, fournissez une représentation JSON pour l’objet mobileAppIntentAndState .
Le tableau suivant présente les propriétés requises lorsque vous créez l’objet mobileAppIntentAndState.
| Propriété | Type | Description |
|---|---|---|
| id | String | UUID pour l’objet |
| managedDeviceIdentifier | String | Identificateur d’appareil créé ou collecté par Intune. |
| userId | String | Identificateur pour l’utilisateur qui tente d’inscrire l’appareil. |
| mobileAppList | collection mobileAppIntentAndStateDetail | Liste des intentions et états de charge utile pour le locataire. |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet mobileAppIntentAndState mis à jour dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
PATCH https://graph.microsoft.com/beta/users/{usersId}/mobileAppIntentAndStates/{mobileAppIntentAndStateId}
Content-type: application/json
Content-length: 831
{
"@odata.type": "#microsoft.graph.mobileAppIntentAndState",
"managedDeviceIdentifier": "Managed Device Identifier value",
"userId": "User Id value",
"mobileAppList": [
{
"@odata.type": "microsoft.graph.mobileAppIntentAndStateDetail",
"applicationId": "Application Id value",
"displayName": "Display Name value",
"mobileAppIntent": "notAvailable",
"displayVersion": "Display Version value",
"installState": "failed",
"supportedDeviceTypes": [
{
"@odata.type": "microsoft.graph.mobileAppSupportedDeviceType",
"type": "windowsRT",
"minimumOperatingSystemVersion": "Minimum Operating System Version value",
"maximumOperatingSystemVersion": "Maximum Operating System Version value"
}
]
}
]
}
Réponse
Voici un exemple de réponse. Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 880
{
"@odata.type": "#microsoft.graph.mobileAppIntentAndState",
"id": "45a775d6-75d6-45a7-d675-a745d675a745",
"managedDeviceIdentifier": "Managed Device Identifier value",
"userId": "User Id value",
"mobileAppList": [
{
"@odata.type": "microsoft.graph.mobileAppIntentAndStateDetail",
"applicationId": "Application Id value",
"displayName": "Display Name value",
"mobileAppIntent": "notAvailable",
"displayVersion": "Display Version value",
"installState": "failed",
"supportedDeviceTypes": [
{
"@odata.type": "microsoft.graph.mobileAppSupportedDeviceType",
"type": "windowsRT",
"minimumOperatingSystemVersion": "Minimum Operating System Version value",
"maximumOperatingSystemVersion": "Maximum Operating System Version value"
}
]
}
]
}