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.
Met à jour les propriétés d’un objet androidForWorkSettings.
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 |
| Déléguée (compte Microsoft personnel) | Non prise en charge. |
| Application | DeviceManagementConfiguration.ReadWrite.All |
Requête HTTP
PATCH /deviceManagement/androidForWorkSettings
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 androidForWorkSettings.
Le tableau suivant illustre les propriétés requises lorsque vous créez l’objet androidForWorkSettings.
| Propriété | Type | Description |
|---|---|---|
| id | String | Identificateur des paramètres Android for Work |
| bindStatus | androidForWorkBindStatus | Lier status du locataire avec l’API Google EMM. Les valeurs possibles sont : notBound, bound, boundAndValidated, unbinding. |
| lastAppSyncDateTime | DateTimeOffset | Dernière heure d’exécution pour la synchronisation de l’application |
| lastAppSyncStatus | androidForWorkSyncStatus | Dernier résultat de synchronisation d’application. Les valeurs possibles sont success, credentialsNotValid, androidForWorkApiError, managementServiceError, unknownError, none. |
| ownerUserPrincipalName | String | UPN du propriétaire ayant créé l’entreprise |
| ownerOrganizationName | String | Nom de l’organisation utilisé lors de l’intégration d’Android for Work |
| lastModifiedDateTime | DateTimeOffset | Dernière heure de modification pour les paramètres Android for Work |
| enrollmentTarget | androidForWorkEnrollmentTarget | Indique quels utilisateurs peuvent inscrire des appareils dans la gestion des appareils Android for Work. Les valeurs possibles sont : none, all, targeted, targetedAsEnrollmentRestrictions. |
| targetGroupIds | String collection | Spécifie les groupes AAD qui peuvent inscrire des appareils dans la gestion des périphériques Android for Work si enrollmentTarget est défini sur « Ciblé » |
| deviceOwnerManagementEnabled | Booléen | Indique si ce compte est en cours de version d’évaluation pour la gestion des propriétaires d’appareils Android avec CloudDPC. |
Réponse
En cas de réussite, cette méthode renvoie un code de réponse 200 OK et un objet androidForWorkSettings mis à jour dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
PATCH https://graph.microsoft.com/beta/deviceManagement/androidForWorkSettings
Content-type: application/json
Content-length: 455
{
"@odata.type": "#microsoft.graph.androidForWorkSettings",
"bindStatus": "bound",
"lastAppSyncDateTime": "2016-12-31T23:57:22.8606813-08:00",
"lastAppSyncStatus": "credentialsNotValid",
"ownerUserPrincipalName": "Owner User Principal Name value",
"ownerOrganizationName": "Owner Organization Name value",
"enrollmentTarget": "all",
"targetGroupIds": [
"Target Group Ids value"
],
"deviceOwnerManagementEnabled": true
}
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: 568
{
"@odata.type": "#microsoft.graph.androidForWorkSettings",
"id": "97adc169-c169-97ad-69c1-ad9769c1ad97",
"bindStatus": "bound",
"lastAppSyncDateTime": "2016-12-31T23:57:22.8606813-08:00",
"lastAppSyncStatus": "credentialsNotValid",
"ownerUserPrincipalName": "Owner User Principal Name value",
"ownerOrganizationName": "Owner Organization Name value",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"enrollmentTarget": "all",
"targetGroupIds": [
"Target Group Ids value"
],
"deviceOwnerManagementEnabled": true
}