Partager via


Mettre à jour androidGeneralDeviceConfiguration

Espace de noms: microsoft.graph

Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.

Met à jour les propriétés d’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

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}

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 les suivantes : none, appsInListCompliant et 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 les suivantes : deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex et 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 les suivantes : browserDefault, blockAlways, allowCurrentWebSite, allowFromWebsitesVisited et 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 200 OK et un objet androidGeneralDeviceConfiguration mis à jour dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande.

PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations/{deviceConfigurationId}
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 200 OK
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
}