Créer androidForWorkGeneralDeviceConfiguration

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
}