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 lorsque cela est 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.
Créez un objet androidForWorkGeneralDeviceConfiguration .
Cette API est disponible dans les déploiements cloud nationaux suivants.
| Service global | Gouvernement américain L4 | Gouvernement américain L5 (DOD) | Chine exploité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 les autorisations. |
| 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 présente les propriétés qui sont 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 | Booléen | Indique si la configuration de l’appareil sous-jacente prend en charge ou non l’attribution de balises d’étendue. L’affectation à la propriété ScopeTags n’est pas autorisée lorsque cette valeur est false et les entités ne seront pas visibles par les utilisateurs délimités. Ce problème 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 | La 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 | Booléen | Indique s’il faut bloquer ou non le déverrouillage du visage. |
| passwordBlockFingerprintUnlock | Boolean | Indique si le déverrouillage par empreinte digitale est bloqué ou non. |
| passwordBlockIrisUnlock | Booléen | Indique s’il faut bloquer ou non le déverrouillage de l’iris. |
| 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. |
| requiredPasswordComplexité | androidRequiredPasswordComplexity | Indique la complexité du mot de passe d’appareil requise sur Android. L’une des options suivantes : AUCUN, FAIBLE, MOYEN, ÉLEVÉ. 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 | Booléen | Indique s’il faut bloquer ou non les notifications lorsque l’appareil est verrouillé. |
| workProfileBlockAddingAccounts | Booléen | Empêcher les utilisateurs d’ajouter/supprimer des comptes dans le profil professionnel. |
| workProfileBluetoothEnableContactSharing | Booléen | Autorisez les appareils Bluetooth à accéder aux contacts de l’entreprise. |
| workProfileBlockScreenCapture | Booléen | Bloquer la capture d’écran dans le profil professionnel. |
| workProfileBlockCrossProfileCallerId | Booléen | Bloquer l’affichage de l’ID de l’appelant du profil professionnel dans le profil personnel. |
| workProfileBlockCamera | Booléen | Bloquer la caméra de profil de travail. |
| workProfileBlockCrossProfileContactsSearch | Booléen | Bloquer la disponibilité des contacts de profil professionnel dans le profil personnel. |
| workProfileBlockCrossProfileCopyPaste | Booléen | Booléen indiquant si le paramètre Interdire la copie/le collage de profils croisés est activé. |
| workProfileDefaultAppPermissionPolicy | androidForWorkDefaultAppPermissionPolicyType | Type de mot de passe nécessaire. Les valeurs possibles sont les suivantes : deviceDefault, prompt, autoGrant, autoDeny. |
| workProfilePasswordBlockFaceUnlock | Booléen | Indique s’il faut bloquer ou non le déverrouillage du visage pour le profil professionnel. |
| workProfilePasswordBlockFingerprintUnlock | Booléen | Indique s’il faut bloquer ou non le déverrouillage par empreinte digitale pour le profil professionnel. |
| workProfilePasswordBlockIrisUnlock | Booléen | Indique s’il faut bloquer ou non le déverrouillage de l’iris pour le profil professionnel. |
| workProfilePasswordBlockTrustAgents | Booléen | Indique s’il faut bloquer ou non Smart Lock et d’autres agents de confiance pour le profil professionnel. |
| 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 de travail. Valeurs valides comprises entre 4 et 16 |
| workProfilePasswordMinNumericCharacters | Int32 | # minimum de caractères numériques requis dans le mot de passe du profil professionnel. Valeurs valides 1 à 10 |
| workProfilePasswordMinNonLetterCharacters | Int32 | # minimum de caractères autres que des lettres requis dans le mot de passe du profil professionnel. Valeurs valides 1 à 10 |
| workProfilePasswordMinLetterCharacters | Int32 | # minimum de caractères lettres requis dans le mot de passe du profil professionnel. Valeurs valides 1 à 10 |
| workProfilePasswordMinLowerCaseCharacters | Int32 | # minimum de caractères minuscules requis dans le mot de passe du profil professionnel. Valeurs valides 1 à 10 |
| workProfilePasswordMinUpperCaseCharacters | Int32 | # minimum de caractères majuscules requis dans le mot de passe du profil professionnel. Valeurs valides 1 à 10 |
| workProfilePasswordMinSymbolCharacters | Int32 | # minimum 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 de travail 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. |
| workProfileRequiredPasswordComplexité | androidRequiredPasswordComplexity | Indique la complexité du mot de passe de profil professionnel requise sur Android. L’une des options suivantes : AUCUN, FAIBLE, MOYEN, ÉLEVÉ. Il s’agit d’une nouvelle API destinée à Android 12+. Les valeurs possibles sont les suivantes : none, low, medium, high. |
| workProfileRequirePassword | Booléen | Le mot de passe est obligatoire ou non pour le profil professionnel |
| securityRequireVerifyApps | Booléen | Exige que la fonctionnalité « Vérifier les applications » d’Android soit activée. |
| vpnAlwaysOnPackageIdentifier | String | Activez le mode de verrouillage pour le VPN toujours actif. |
| vpnEnableAlwaysOnLockdownMode | Booléen | Activez le mode de verrouillage pour le VPN toujours actif. |
| workProfileAllowWidgets | Booléen | Autoriser les widgets des applications de profil professionnel. |
| workProfileBlockPersonalAppInstallsFromUnknownSources | Booléen | 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éterminer la liste verte des domaines pour les comptes qui peuvent être ajoutés au profil professionnel. |
| blockUnifiedPasswordForWorkProfile | Booléen | Empêchez l’utilisation d’un mot de passe unifié pour déverrouiller l’appareil et le profil professionnel. |
Réponse
En cas de réussite, cette méthode renvoie un code de 201 Created 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
}