Créer androidForWorkGeneralDeviceConfiguration
Espace de noms: microsoft.graph
Important: Les API Microsoft Graph sous la version /beta sont susceptibles d’être modifiées ; l’utilisation de production n’est pas prise en charge.
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
Créez un objet androidForWorkGeneralDeviceConfiguration .
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
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations
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 androidForWorkGeneralDeviceConfiguration.
Le tableau suivant indique les propriétés requises lorsque vous créez androidForWorkGeneralDeviceConfiguration.
| 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. |
| roleScopeTagIds | String collection | Liste des balises d’étendue pour cette instance d’entité. Hérité de deviceConfiguration. |
| supportsScopeTags | Valeur booléenne | Indique si la configuration d’appareil sous-jacente prend en charge l’attribution des balises d’étendue. L’attribution à la propriété ScopeTags n’est pas autorisée lorsque cette valeur est false et que les entités ne sont pas visibles par les utilisateurs délimités. Cela se produit pour les stratégies héritées créées dans Silverlight et peut être résolu en supprimant et en recréant la stratégie dans le portail Azure. Cette propriété est en lecture seule. Hérité de deviceConfiguration. |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | Applicabilité de l’édition du système d’exploitation pour cette stratégie. Hérité de deviceConfiguration. |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | Règle d’applicabilité de la version du système d’exploitation pour cette stratégie. Hérité de deviceConfiguration. |
| deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | Règle d’applicabilité du mode appareil pour cette stratégie. 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é de deviceConfiguration. |
| passwordBlockFaceUnlock | Valeur booléenne | Indique si le déverrouillage du visage doit être bloqué ou non. |
| passwordBlockFingerprintUnlock | Boolean | Indique si le déverrouillage par empreinte digitale est bloqué ou non. |
| passwordBlockIrisUnlock | Valeur booléenne | Indique si le déverrouillage de l’iris doit être 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 | androidForWorkRequiredPasswordType | Type de mot de passe nécessaire. Les valeurs possibles sont les suivantes : deviceDefault, lowSecurityBiometric, required, atLeastNumeric, numericComplex, atLeastAlphabetic, atLeastAlphanumeric et alphanumericWithSymbols. |
| requiredPasswordComplexity | androidRequiredPasswordComplexity | Indique la complexité requise du mot de passe de l’appareil sur Android. Un des éléments suivants : NONE, LOW, MEDIUM, HIGH. Il s’agit d’une nouvelle API destinée à Android 12+. Les valeurs possibles sont les suivantes : none, low, medium, high. |
| workProfileDataSharingType | androidForWorkCrossProfileDataSharingType | Type de partage de données autorisé. Les valeurs possibles sont les suivantes : deviceDefault, preventAny, allowPersonalToWork, noRestrictions. |
| workProfileBlockNotificationsWhileDeviceLocked | Valeur booléenne | Indique si les notifications doivent être bloquées ou non lorsque l’appareil est verrouillé. |
| workProfileBlockAddingAccounts | Valeur booléenne | Empêcher les utilisateurs d’ajouter/supprimer des comptes dans un profil professionnel. |
| workProfileBluetoothEnableContactSharing | Valeur booléenne | Autoriser les appareils Bluetooth à accéder aux contacts d’entreprise. |
| workProfileBlockScreenCapture | Valeur booléenne | Bloquer la capture d’écran dans le profil professionnel. |
| workProfileBlockCrossProfileCallerId | Valeur booléenne | Bloquer l’affichage de l’ID d’appelant du profil professionnel dans le profil personnel. |
| workProfileBlockCamera | Valeur booléenne | Bloquer la caméra de profil professionnel. |
| workProfileBlockCrossProfileContactsSearch | Valeur booléenne | Bloquer la disponibilité des contacts de profil professionnel dans le profil personnel. |
| workProfileBlockCrossProfileCopyPaste | Valeur booléenne | Valeur booléenne qui indique si le paramètre interdire le copier/coller de profil croisé est activé. |
| workProfileDefaultAppPermissionPolicy | androidForWorkDefaultAppPermissionPolicyType | Type de mot de passe nécessaire. Les valeurs possibles sont les suivantes : deviceDefault, prompt, autoGrant, autoDeny. |
| workProfilePasswordBlockFaceUnlock | Valeur booléenne | Indique si le déverrouillage du visage pour le profil professionnel doit être bloqué ou non. |
| workProfilePasswordBlockFingerprintUnlock | Valeur booléenne | Indique si le déverrouillage par empreinte digitale pour le profil professionnel doit être bloqué ou non. |
| workProfilePasswordBlockIrisUnlock | Valeur booléenne | Indique s’il faut bloquer ou non le déverrouillage de l’iris pour le profil professionnel. |
| workProfilePasswordBlockTrustAgents | Valeur booléenne | Indique si le verrouillage intelligent et d’autres agents d’approbation pour le profil professionnel doivent être bloqués ou non. |
| workProfilePasswordExpirationDays | Int32 | Nombre de jours avant l’expiration du mot de passe du profil professionnel. Valeurs valides comprises entre 1 et 365 |
| workProfilePasswordMinimumLength | Int32 | Longueur minimale du mot de passe du profil professionnel. Valeurs valides comprises entre 4 et 16 |
| workProfilePasswordMinNumericCharacters | Int32 | Nombre minimal de caractères numériques requis dans le mot de passe du profil professionnel. Valeurs valides 1 à 10 |
| workProfilePasswordMinNonLetterCharacters | Int32 | Nombre minimal de caractères autres que des lettres requis dans le mot de passe du profil professionnel. Valeurs valides 1 à 10 |
| workProfilePasswordMinLetterCharacters | Int32 | Nombre minimal de caractères de lettre requis dans le mot de passe du profil professionnel. Valeurs valides 1 à 10 |
| workProfilePasswordMinLowerCaseCharacters | Int32 | Nombre minimal de caractères en minuscules requis dans le mot de passe du profil professionnel. Valeurs valides 1 à 10 |
| workProfilePasswordMinUpperCaseCharacters | Int32 | Nombre minimal de caractères majuscules requis dans le mot de passe du profil professionnel. Valeurs valides 1 à 10 |
| workProfilePasswordMinSymbolCharacters | Int32 | Nombre minimal de symboles requis dans le mot de passe du profil professionnel. Valeurs valides 1 à 10 |
| workProfilePasswordMinutesOfInactivityBeforeScreenTimeout | Int32 | Minutes d’inactivité avant l’extinction de l’écran. |
| workProfilePasswordPreviousPasswordBlockCount | Int32 | Nombre de mots de passe de profil professionnel précédents à bloquer. Valeurs valides comprises entre 0 et 24 |
| workProfilePasswordSignInFailureCountBeforeFactoryReset | Int32 | Nombre d’échecs de connexion autorisés avant la suppression du profil professionnel et la suppression de toutes les données d’entreprise. Valeurs valides 1 à 16 |
| workProfilePasswordRequiredType | androidForWorkRequiredPasswordType | Type de mot de passe de profil professionnel requis. Les valeurs possibles sont les suivantes : deviceDefault, lowSecurityBiometric, required, atLeastNumeric, numericComplex, atLeastAlphabetic, atLeastAlphanumeric et alphanumericWithSymbols. |
| workProfileRequiredPasswordComplexity | androidRequiredPasswordComplexity | Indique la complexité requise du mot de passe du profil professionnel sur Android. Un des éléments suivants : NONE, LOW, MEDIUM, HIGH. Il s’agit d’une nouvelle API destinée à Android 12+. Les valeurs possibles sont les suivantes : none, low, medium, high. |
| workProfileRequirePassword | Valeur booléenne | Le mot de passe est requis ou non pour le profil professionnel |
| securityRequireVerifyApps | Booléen | Exige que la fonctionnalité « Vérifier les applications » d’Android soit activée. |
| vpnAlwaysOnPackageIdentifier | Chaîne | Activez le mode de verrouillage pour le VPN always-on. |
| vpnEnableAlwaysOnLockdownMode | Valeur booléenne | Activez le mode de verrouillage pour le VPN always-on. |
| workProfileAllowWidgets | Valeur booléenne | Autoriser les widgets des applications de profil professionnel. |
| workProfileBlockPersonalAppInstallsFromUnknownSources | Valeur booléenne | Empêcher les installations d’applications à partir de sources inconnues dans le profil personnel. |
| workProfileAccountUse | androidWorkProfileAccountUse | Contrôler la capacité de l’utilisateur à ajouter des comptes dans le profil professionnel, y compris les comptes Google. Les valeurs possibles sont les suivantes : allowAllExceptGoogleAccounts, blockAll, allowAll, unknownFutureValue. |
| allowedGoogleAccountDomains | String collection | Déterminez la liste verte des domaines pour les comptes qui peuvent être ajoutés au profil professionnel. |
| blockUnifiedPasswordForWorkProfile | Valeur booléenne | Empêchez l’utilisation d’un mot de passe unifié pour déverrouiller l’appareil et le profil professionnel. |
Réponse
Si elle réussit, cette méthode renvoie un 201 Created code de réponse et un objet androidForWorkGeneralDeviceConfiguration dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 3343
{
"@odata.type": "#microsoft.graph.androidForWorkGeneralDeviceConfiguration",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"passwordBlockFaceUnlock": true,
"passwordBlockFingerprintUnlock": true,
"passwordBlockIrisUnlock": true,
"passwordBlockTrustAgents": true,
"passwordExpirationDays": 6,
"passwordMinimumLength": 5,
"passwordMinutesOfInactivityBeforeScreenTimeout": 14,
"passwordPreviousPasswordBlockCount": 2,
"passwordSignInFailureCountBeforeFactoryReset": 12,
"passwordRequiredType": "lowSecurityBiometric",
"requiredPasswordComplexity": "low",
"workProfileDataSharingType": "preventAny",
"workProfileBlockNotificationsWhileDeviceLocked": true,
"workProfileBlockAddingAccounts": true,
"workProfileBluetoothEnableContactSharing": true,
"workProfileBlockScreenCapture": true,
"workProfileBlockCrossProfileCallerId": true,
"workProfileBlockCamera": true,
"workProfileBlockCrossProfileContactsSearch": true,
"workProfileBlockCrossProfileCopyPaste": true,
"workProfileDefaultAppPermissionPolicy": "prompt",
"workProfilePasswordBlockFaceUnlock": true,
"workProfilePasswordBlockFingerprintUnlock": true,
"workProfilePasswordBlockIrisUnlock": true,
"workProfilePasswordBlockTrustAgents": true,
"workProfilePasswordExpirationDays": 1,
"workProfilePasswordMinimumLength": 0,
"workProfilePasswordMinNumericCharacters": 7,
"workProfilePasswordMinNonLetterCharacters": 9,
"workProfilePasswordMinLetterCharacters": 6,
"workProfilePasswordMinLowerCaseCharacters": 9,
"workProfilePasswordMinUpperCaseCharacters": 9,
"workProfilePasswordMinSymbolCharacters": 6,
"workProfilePasswordMinutesOfInactivityBeforeScreenTimeout": 9,
"workProfilePasswordPreviousPasswordBlockCount": 13,
"workProfilePasswordSignInFailureCountBeforeFactoryReset": 7,
"workProfilePasswordRequiredType": "lowSecurityBiometric",
"workProfileRequiredPasswordComplexity": "low",
"workProfileRequirePassword": true,
"securityRequireVerifyApps": true,
"vpnAlwaysOnPackageIdentifier": "Vpn Always On Package Identifier value",
"vpnEnableAlwaysOnLockdownMode": true,
"workProfileAllowWidgets": true,
"workProfileBlockPersonalAppInstallsFromUnknownSources": true,
"workProfileAccountUse": "blockAll",
"allowedGoogleAccountDomains": [
"Allowed Google Account Domains value"
],
"blockUnifiedPasswordForWorkProfile": 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: 3515
{
"@odata.type": "#microsoft.graph.androidForWorkGeneralDeviceConfiguration",
"id": "a931a366-a366-a931-66a3-31a966a331a9",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"passwordBlockFaceUnlock": true,
"passwordBlockFingerprintUnlock": true,
"passwordBlockIrisUnlock": true,
"passwordBlockTrustAgents": true,
"passwordExpirationDays": 6,
"passwordMinimumLength": 5,
"passwordMinutesOfInactivityBeforeScreenTimeout": 14,
"passwordPreviousPasswordBlockCount": 2,
"passwordSignInFailureCountBeforeFactoryReset": 12,
"passwordRequiredType": "lowSecurityBiometric",
"requiredPasswordComplexity": "low",
"workProfileDataSharingType": "preventAny",
"workProfileBlockNotificationsWhileDeviceLocked": true,
"workProfileBlockAddingAccounts": true,
"workProfileBluetoothEnableContactSharing": true,
"workProfileBlockScreenCapture": true,
"workProfileBlockCrossProfileCallerId": true,
"workProfileBlockCamera": true,
"workProfileBlockCrossProfileContactsSearch": true,
"workProfileBlockCrossProfileCopyPaste": true,
"workProfileDefaultAppPermissionPolicy": "prompt",
"workProfilePasswordBlockFaceUnlock": true,
"workProfilePasswordBlockFingerprintUnlock": true,
"workProfilePasswordBlockIrisUnlock": true,
"workProfilePasswordBlockTrustAgents": true,
"workProfilePasswordExpirationDays": 1,
"workProfilePasswordMinimumLength": 0,
"workProfilePasswordMinNumericCharacters": 7,
"workProfilePasswordMinNonLetterCharacters": 9,
"workProfilePasswordMinLetterCharacters": 6,
"workProfilePasswordMinLowerCaseCharacters": 9,
"workProfilePasswordMinUpperCaseCharacters": 9,
"workProfilePasswordMinSymbolCharacters": 6,
"workProfilePasswordMinutesOfInactivityBeforeScreenTimeout": 9,
"workProfilePasswordPreviousPasswordBlockCount": 13,
"workProfilePasswordSignInFailureCountBeforeFactoryReset": 7,
"workProfilePasswordRequiredType": "lowSecurityBiometric",
"workProfileRequiredPasswordComplexity": "low",
"workProfileRequirePassword": true,
"securityRequireVerifyApps": true,
"vpnAlwaysOnPackageIdentifier": "Vpn Always On Package Identifier value",
"vpnEnableAlwaysOnLockdownMode": true,
"workProfileAllowWidgets": true,
"workProfileBlockPersonalAppInstallsFromUnknownSources": true,
"workProfileAccountUse": "blockAll",
"allowedGoogleAccountDomains": [
"Allowed Google Account Domains value"
],
"blockUnifiedPasswordForWorkProfile": true
}