Mettre à jour iosManagedAppProtection

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 iosManagedAppProtection.

Conditions préalables

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) DeviceManagementApps.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application DeviceManagementApps.ReadWrite.All

Requête HTTP

PATCH /deviceAppManagement/iosManagedAppProtections/{iosManagedAppProtectionId}

En-têtes de demande

En-tête Valeur
Autorisation Porteur <token> obligatoire.
Accepter application/json

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON pour l’objet iosManagedAppProtection.

Le tableau suivant indique les propriétés qui sont requises lorsque vous créez l’objet iosManagedAppProtection.

Propriété Type Description
displayName String Nom d’affichage de la stratégie. Hérité de managedAppPolicy.
description String Description de la stratégie. Hérité de managedAppPolicy.
createdDateTime DateTimeOffset Date et heure de la création de la stratégie. Hérité de managedAppPolicy.
lastModifiedDateTime DateTimeOffset Dernière modification de la stratégie. Hérité de managedAppPolicy.
id String Clé de l’entité. Hérité de managedAppPolicy.
version String Version de l’entité. Hérité de managedAppPolicy.
periodOfflineBeforeAccessCheck Duration Période après laquelle l’accès est vérifié lorsque l’appareil n’est pas connecté à Internet. Hérité de managedAppProtection
periodOnlineBeforeAccessCheck Duration Période après laquelle l’accès est vérifié lorsque l’appareil est connecté à Internet. Hérité de managedAppProtection
allowedInboundDataTransferSources managedAppDataTransferLevel Sources à partir desquelles les données sont autorisées à être transférées. Hérité de managedAppProtection. Les valeurs possibles sont les suivantes : allApps, managedApps et none.
allowedOutboundDataTransferDestinations managedAppDataTransferLevel Destinations vers lesquelles les données sont autorisées à être transférées. Hérité de managedAppProtection. Les valeurs possibles sont les suivantes : allApps, managedApps et none.
organizationalCredentialsRequired Booléen Indique si les informations d’identification de votre organisation sont requises pour utiliser l’application. Hérité de managedAppProtection
allowedOutboundClipboardSharingLevel managedAppClipboardSharingLevel Niveau auquel le Presse-papiers peut être partagé entre les applications sur l’appareil géré. Hérité de managedAppProtection. Les valeurs possibles sont les suivantes : allApps, managedAppsWithPasteIn, managedApps et blocked.
dataBackupBlocked Booléen Indique si la sauvegarde des données de l’application gérée est bloquée. Hérité de managedAppProtection
deviceComplianceRequired Booléen Indique si la conformité de l’appareil est requise. Hérité de managedAppProtection
managedBrowserToOpenLinksRequired Booléen Indique si les liens Internet doivent être ouverts dans l’application de navigateur géré ou tout navigateur personnalisé spécifié par CustomBrowserProtocol (pour iOS) ou CustomBrowserPackageId/CustomBrowserDisplayName (pour Android) Hérité de managedAppProtection
saveAsBlocked Booléen Indique si les utilisateurs peuvent utiliser l’élément de menu « Enregistrer sous » pour enregistrer une copie des fichiers protégés. Hérité de managedAppProtection
periodOfflineBeforeWipeIsEnforced Duration La durée pendant laquelle une application est autorisée à rester déconnectée d’Internet avant la réinitialisation de toutes les données gérées. Hérité de managedAppProtection
pinRequired Booléen Indique si un code confidentiel au niveau de l’application est requis. Hérité de managedAppProtection
maximumPinRetries Int32 Nombre maximal de tentatives de broche incorrectes avant que l’application gérée ne soit bloquée ou effacée. Hérité de managedAppProtection
simplePinBlocked Booléen Indique si simplePin est bloqué. Hérité de managedAppProtection
minimumPinLength Int32 Longueur minimale requise du code confidentiel pour un code confidentiel au niveau de l’application si PinRequired est défini sur True - Hérité de managedAppProtection
pinCharacterSet managedAppPinCharacterSet Jeu de caractères pouvant être utilisé pour un code confidentiel au niveau de l’application si PinRequired est défini sur True. Hérité de managedAppProtection. Les valeurs possibles sont les suivantes : numeric et alphanumericAndSymbol.
periodBeforePinReset Duration Période avant que le code confidentiel pour tous les niveaux soit réinitialisé si PinRequired est défini sur True. Hérité de managedAppProtection
allowedDataStorageLocations collection managedAppDataStorageLocation Emplacements de stockage de données dans lesquels un utilisateur peut stocker des données gérées. Hérité de managedAppProtection. Les valeurs possibles sont les suivantes : oneDriveForBusiness, sharePoint, box, localStorage.
contactSyncBlocked Booléen Indique si des contacts peuvent être synchronisés sur l’appareil de l’utilisateur. Hérité de managedAppProtection
printBlocked Booléen Indique si l’impression est autorisée à partir d’applications gérées. Hérité de managedAppProtection
fingerprintBlocked Booléen Indique si l’utilisation du lecteur d’empreintes digitales est autorisée à la place d’un code confidentiel si PinRequired est défini sur True. Hérité de managedAppProtection
disableAppPinIfDevicePinIsSet Booléen Indique si l’utilisation du code confidentiel de l’application est requise si le code confidentiel de l’appareil est défini. Hérité de managedAppProtection
minimumRequiredOsVersion String Les versions inférieures à celle spécifiée empêcheront l’application gérée d’accéder aux données de l’entreprise. Hérité de managedAppProtection
minimumWarningOsVersion String Les versions inférieures à celle spécifiée engendreront des messages d’avertissement sur l’application gérée lors de l’accès aux données de l’entreprise. Hérité de managedAppProtection
minimumRequiredAppVersion String Les versions inférieures à celle spécifiée empêcheront l’application gérée d’accéder aux données de l’entreprise. Hérité de managedAppProtection
minimumWarningAppVersion String Les versions inférieures à celle spécifiée engendreront des messages d’avertissement sur l’application gérée. Hérité de managedAppProtection
managedBrowser managedBrowserType Indique dans quels navigateurs gérés les liens Internet doivent être ouverts. Lorsque cette propriété est configurée, ManagedBrowserToOpenLinksRequired doit être true. Hérité de managedAppProtection. Les valeurs possibles sont les suivantes : notConfigured, microsoftEdge.
isAssigned Booléen Indique si la stratégie est déployée sur un groupe d’inclusion ou non. Hérité de targetedManagedAppProtection
appDataEncryptionType managedAppDataEncryptionType Type de chiffrement devant être utilisé pour les données dans une application gérée. Les valeurs possibles sont les suivantes : useDeviceSettings, afterDeviceRestart, whenDeviceLockedExceptOpenFiles et whenDeviceLocked.
minimumRequiredSdkVersion String Les versions inférieures à celle spécifiée empêcheront l’application gérée d’accéder aux données de l’entreprise.
deployedAppCount Int32 Nombre d’applications sur lesquelles la stratégie actuelle est déployée.
faceIdBlocked Booléen Indique si l’utilisation de FaceID est autorisée à la place d’un code confidentiel si PinRequired est défini sur True.
customBrowserProtocol String Protocole de navigateur personnalisé pour ouvrir un lien web sur iOS. Lorsque cette propriété est configurée, ManagedBrowserToOpenLinksRequired doit être true.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et un objet iosManagedAppProtection mis à jour dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande.

PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/iosManagedAppProtections/{iosManagedAppProtectionId}
Content-type: application/json
Content-length: 1667

{
  "@odata.type": "#microsoft.graph.iosManagedAppProtection",
  "displayName": "Display Name value",
  "description": "Description value",
  "version": "Version value",
  "periodOfflineBeforeAccessCheck": "-PT17.1357909S",
  "periodOnlineBeforeAccessCheck": "PT35.0018757S",
  "allowedInboundDataTransferSources": "managedApps",
  "allowedOutboundDataTransferDestinations": "managedApps",
  "organizationalCredentialsRequired": true,
  "allowedOutboundClipboardSharingLevel": "managedAppsWithPasteIn",
  "dataBackupBlocked": true,
  "deviceComplianceRequired": true,
  "managedBrowserToOpenLinksRequired": true,
  "saveAsBlocked": true,
  "periodOfflineBeforeWipeIsEnforced": "-PT3M22.1587532S",
  "pinRequired": true,
  "maximumPinRetries": 1,
  "simplePinBlocked": true,
  "minimumPinLength": 0,
  "pinCharacterSet": "alphanumericAndSymbol",
  "periodBeforePinReset": "PT3M29.6631862S",
  "allowedDataStorageLocations": [
    "sharePoint"
  ],
  "contactSyncBlocked": true,
  "printBlocked": true,
  "fingerprintBlocked": true,
  "disableAppPinIfDevicePinIsSet": true,
  "minimumRequiredOsVersion": "Minimum Required Os Version value",
  "minimumWarningOsVersion": "Minimum Warning Os Version value",
  "minimumRequiredAppVersion": "Minimum Required App Version value",
  "minimumWarningAppVersion": "Minimum Warning App Version value",
  "managedBrowser": "microsoftEdge",
  "isAssigned": true,
  "appDataEncryptionType": "afterDeviceRestart",
  "minimumRequiredSdkVersion": "Minimum Required Sdk Version value",
  "deployedAppCount": 0,
  "faceIdBlocked": true,
  "customBrowserProtocol": "Custom Browser Protocol value"
}

Réponse

Voici un exemple de la 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: 1839

{
  "@odata.type": "#microsoft.graph.iosManagedAppProtection",
  "displayName": "Display Name value",
  "description": "Description value",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "id": "5bc789cb-89cb-5bc7-cb89-c75bcb89c75b",
  "version": "Version value",
  "periodOfflineBeforeAccessCheck": "-PT17.1357909S",
  "periodOnlineBeforeAccessCheck": "PT35.0018757S",
  "allowedInboundDataTransferSources": "managedApps",
  "allowedOutboundDataTransferDestinations": "managedApps",
  "organizationalCredentialsRequired": true,
  "allowedOutboundClipboardSharingLevel": "managedAppsWithPasteIn",
  "dataBackupBlocked": true,
  "deviceComplianceRequired": true,
  "managedBrowserToOpenLinksRequired": true,
  "saveAsBlocked": true,
  "periodOfflineBeforeWipeIsEnforced": "-PT3M22.1587532S",
  "pinRequired": true,
  "maximumPinRetries": 1,
  "simplePinBlocked": true,
  "minimumPinLength": 0,
  "pinCharacterSet": "alphanumericAndSymbol",
  "periodBeforePinReset": "PT3M29.6631862S",
  "allowedDataStorageLocations": [
    "sharePoint"
  ],
  "contactSyncBlocked": true,
  "printBlocked": true,
  "fingerprintBlocked": true,
  "disableAppPinIfDevicePinIsSet": true,
  "minimumRequiredOsVersion": "Minimum Required Os Version value",
  "minimumWarningOsVersion": "Minimum Warning Os Version value",
  "minimumRequiredAppVersion": "Minimum Required App Version value",
  "minimumWarningAppVersion": "Minimum Warning App Version value",
  "managedBrowser": "microsoftEdge",
  "isAssigned": true,
  "appDataEncryptionType": "afterDeviceRestart",
  "minimumRequiredSdkVersion": "Minimum Required Sdk Version value",
  "deployedAppCount": 0,
  "faceIdBlocked": true,
  "customBrowserProtocol": "Custom Browser Protocol value"
}