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
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
Crée un objet androidGeneralDeviceConfiguration.
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
POST /deviceManagement/deviceConfigurations
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 androidGeneralDeviceConfiguration.
Le tableau suivant indique les propriétés qui sont requises lorsque vous créez l’objet androidGeneralDeviceConfiguration.
| Propriété | Type | Description |
|---|---|---|
| id | String | Clé de l’entité. Hérité de deviceConfiguration. |
| lastModifiedDateTime | DateTimeOffset | Date et heure de dernière modification de l’objet. Hérité de deviceConfiguration. |
| createdDateTime | DateTimeOffset | Date et heure de création de l’objet. Hérité de deviceConfiguration. |
| description | String | Description de la configuration de l’appareil fournie par l’administrateur. Hérité de deviceConfiguration. |
| displayName | String | Nom de la configuration de l’appareil fourni par l’administrateur. Hérité de deviceConfiguration. |
| version | Int32 | Version de la configuration de l’appareil. Hérité du type de ressource deviceConfiguration |
| appsBlockClipboardSharing | Boolean | Indique si le partage du Presse-papiers est bloqué ou non pour copier et coller des éléments entre des applications. |
| appsBlockCopyPaste | Boolean | Indique si l’action copier-coller est bloquée ou non à l’intérieur des applications. |
| appsBlockYouTube | Boolean | Indique si l’application YouTube est bloquée ou non. |
| bluetoothBlocked | Boolean | Indique si le Bluetooth est bloqué ou non. |
| cameraBlocked | Boolean | Indique si l’utilisation de l’appareil photo est bloquée ou non. |
| cellularBlockDataRoaming | Booléen | Indique si les données d’itinérance sont bloquées ou non. |
| cellularBlockMessaging | Boolean | Indique si les messages SMS/MMS sont bloqués ou non. |
| cellularBlockVoiceRoaming | Booléen | Indique si l’itinérance vocale est bloquée ou non. |
| cellularBlockWiFiTethering | Boolean | Indique si la synchronisation de la connexion Wi-Fi est bloquée ou non. |
| compliantAppsList | Collection appListItem | Liste des applications de conformité (liste verte ou liste rouge contrôlée par CompliantAppListType). Cette collection peut contenir 10 000 éléments au maximum. |
| compliantAppListType | appListType | Type de liste se trouvant dans CompliantAppsList. Les valeurs possibles sont none, appsInListCompliant, appsNotInListCompliant. |
| diagnosticDataBlockSubmission | Booléen | Indique si l’envoi de données diagnostic est bloqué ou non. |
| locationServicesBlocked | Booléen | Indique si les services d’emplacement sont bloqués ou non. |
| googleAccountBlockAutoSync | Boolean | Indique si la synchronisation automatique des comptes Google est bloquée ou non. |
| googlePlayStoreBlocked | Boolean | Indique si le Google Play Store est bloqué. |
| kioskModeBlockSleepButton | Boolean | Indique si le bouton de veille de l’écran est bloqué en mode plein écran. |
| kioskModeBlockVolumeButtons | Boolean | Indique si les boutons de volume sont autorisés ou non en mode plein écran. |
| kioskModeApps | Collection appListItem | Liste des applications qui sont autorisées à être exécutées lorsque l’appareil est en mode plein écran. Cette collection peut contenir 500 éléments au maximum. |
| nfcBlocked | Booléen | Indique si la communication en champ proche est bloquée ou non. |
| passwordBlockFingerprintUnlock | Boolean | Indique si le déverrouillage par empreinte digitale est bloqué ou non. |
| passwordBlockTrustAgents | Boolean | Indique si la fonctionnalité Smart Lock et d’autres agents approuvés sont bloqués ou non. |
| passwordExpirationDays | Int32 | Nombre de jours avant l’expiration du mot de passe. Valeurs valides comprises entre 1 et 365 |
| passwordMinimumLength | Int32 | Longueur minimale de mots de passe. Valeurs valides comprises entre 4 et 16 |
| passwordMinutesOfInactivityBeforeScreenTimeout | Int32 | Minutes d’inactivité avant l’extinction de l’écran. |
| passwordPreviousPasswordBlockCount | Int32 | Nombre de mots de passe précédents à bloquer. Valeurs valides comprises entre 0 et 24 |
| passwordSignInFailureCountBeforeFactoryReset | Int32 | Nombre d’échecs de connexion autorisés avant la réinitialisation des paramètres d’usine. Valeurs valides 1 à 16 |
| passwordRequiredType | androidRequiredPasswordType | Type de mot de passe nécessaire. Les valeurs possibles sont : deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex, , . any |
| passwordRequired | Booléen | Indique si un mot de passe est exigé ou non. |
| powerOffBlocked | Boolean | Indique si la mise hors tension de l’appareil est bloquée ou non. |
| factoryResetBlocked | Boolean | Indique si l’utilisateur peut ou non effectuer une réinitialisation des paramètres d’usine. |
| screenCaptureBlocked | Booléen | Indique si les captures d’écran sont bloquées ou non. |
| deviceSharingAllowed | Boolean | Indique si le mode de partage d’appareil est autorisé ou non. |
| storageBlockGoogleBackup | Boolean | Indique si la sauvegarde Google est bloquée ou non. |
| storageBlockRemovableStorage | Boolean | Indique si l’utilisation du stockage amovible est bloquée ou non. |
| storageRequireDeviceEncryption | Boolean | Indique si le chiffrement de l’appareil est exigé ou non. |
| storageRequireRemovableStorageEncryption | Boolean | Indique si le chiffrement du stockage amovible de l’appareil est exigé ou non. |
| voiceAssistantBlocked | Boolean | Indique si l’utilisation de l’assistant vocal est bloquée ou non. |
| voiceDialingBlocked | Booléen | Indique si la numérotation vocale est bloquée ou non. |
| webBrowserBlockPopups | Boolean | Indique si les fenêtres contextuelles sont bloquées ou non dans le navigateur web. |
| webBrowserBlockAutofill | Boolean | Indique si la fonctionnalité de remplissage automatique du navigateur web est bloquée ou non. |
| webBrowserBlockJavaScript | Boolean | Indique si JavaScript est bloqué ou non dans le navigateur web. |
| webBrowserBlocked | Booléen | Indique si le navigateur web est bloqué ou non. |
| webBrowserCookieSettings | webBrowserCookieSettings | Paramètres de cookies dans le navigateur web. Les valeurs possibles sont : browserDefault, blockAlways, allowCurrentWebSite, allowFromWebsitesVisited, allowAlways. |
| wiFiBlocked | Boolean | Indique si la synchronisation Wi-Fi est bloquée ou non. |
| appsInstallAllowList | Collection appListItem | Liste des applications pouvant être installées sur l’appareil KNOX. Cette collection peut contenir 500 éléments au maximum. |
| appsLaunchBlockList | Collection appListItem | Liste des applications ne pouvant pas être lancées sur l’appareil KNOX. Cette collection peut contenir 500 éléments au maximum. |
| appsHideList | Collection appListItem | Liste des applications à masquer sur l’appareil KNOX. Cette collection peut contenir 500 éléments au maximum. |
| securityRequireVerifyApps | Booléen | Exige que la fonctionnalité « Vérifier les applications » d’Android soit activée. |
Réponse
Si elle réussit, cette méthode renvoie un code de réponse 201 Created et un objet androidGeneralDeviceConfiguration dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
POST https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 3033
{
"@odata.type": "#microsoft.graph.androidGeneralDeviceConfiguration",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"appsBlockClipboardSharing": true,
"appsBlockCopyPaste": true,
"appsBlockYouTube": true,
"bluetoothBlocked": true,
"cameraBlocked": true,
"cellularBlockDataRoaming": true,
"cellularBlockMessaging": true,
"cellularBlockVoiceRoaming": true,
"cellularBlockWiFiTethering": true,
"compliantAppsList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"compliantAppListType": "appsInListCompliant",
"diagnosticDataBlockSubmission": true,
"locationServicesBlocked": true,
"googleAccountBlockAutoSync": true,
"googlePlayStoreBlocked": true,
"kioskModeBlockSleepButton": true,
"kioskModeBlockVolumeButtons": true,
"kioskModeApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"nfcBlocked": true,
"passwordBlockFingerprintUnlock": true,
"passwordBlockTrustAgents": true,
"passwordExpirationDays": 6,
"passwordMinimumLength": 5,
"passwordMinutesOfInactivityBeforeScreenTimeout": 14,
"passwordPreviousPasswordBlockCount": 2,
"passwordSignInFailureCountBeforeFactoryReset": 12,
"passwordRequiredType": "alphabetic",
"passwordRequired": true,
"powerOffBlocked": true,
"factoryResetBlocked": true,
"screenCaptureBlocked": true,
"deviceSharingAllowed": true,
"storageBlockGoogleBackup": true,
"storageBlockRemovableStorage": true,
"storageRequireDeviceEncryption": true,
"storageRequireRemovableStorageEncryption": true,
"voiceAssistantBlocked": true,
"voiceDialingBlocked": true,
"webBrowserBlockPopups": true,
"webBrowserBlockAutofill": true,
"webBrowserBlockJavaScript": true,
"webBrowserBlocked": true,
"webBrowserCookieSettings": "blockAlways",
"wiFiBlocked": true,
"appsInstallAllowList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"appsLaunchBlockList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"appsHideList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"securityRequireVerifyApps": 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 201 Created
Content-Type: application/json
Content-Length: 3205
{
"@odata.type": "#microsoft.graph.androidGeneralDeviceConfiguration",
"id": "9e00d534-d534-9e00-34d5-009e34d5009e",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"appsBlockClipboardSharing": true,
"appsBlockCopyPaste": true,
"appsBlockYouTube": true,
"bluetoothBlocked": true,
"cameraBlocked": true,
"cellularBlockDataRoaming": true,
"cellularBlockMessaging": true,
"cellularBlockVoiceRoaming": true,
"cellularBlockWiFiTethering": true,
"compliantAppsList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"compliantAppListType": "appsInListCompliant",
"diagnosticDataBlockSubmission": true,
"locationServicesBlocked": true,
"googleAccountBlockAutoSync": true,
"googlePlayStoreBlocked": true,
"kioskModeBlockSleepButton": true,
"kioskModeBlockVolumeButtons": true,
"kioskModeApps": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"nfcBlocked": true,
"passwordBlockFingerprintUnlock": true,
"passwordBlockTrustAgents": true,
"passwordExpirationDays": 6,
"passwordMinimumLength": 5,
"passwordMinutesOfInactivityBeforeScreenTimeout": 14,
"passwordPreviousPasswordBlockCount": 2,
"passwordSignInFailureCountBeforeFactoryReset": 12,
"passwordRequiredType": "alphabetic",
"passwordRequired": true,
"powerOffBlocked": true,
"factoryResetBlocked": true,
"screenCaptureBlocked": true,
"deviceSharingAllowed": true,
"storageBlockGoogleBackup": true,
"storageBlockRemovableStorage": true,
"storageRequireDeviceEncryption": true,
"storageRequireRemovableStorageEncryption": true,
"voiceAssistantBlocked": true,
"voiceDialingBlocked": true,
"webBrowserBlockPopups": true,
"webBrowserBlockAutofill": true,
"webBrowserBlockJavaScript": true,
"webBrowserBlocked": true,
"webBrowserCookieSettings": "blockAlways",
"wiFiBlocked": true,
"appsInstallAllowList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"appsLaunchBlockList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"appsHideList": [
{
"@odata.type": "microsoft.graph.appListItem",
"name": "Name value",
"publisher": "Publisher value",
"appStoreUrl": "https://example.com/appStoreUrl/",
"appId": "App Id value"
}
],
"securityRequireVerifyApps": true
}