Partager via

Créer win32LobApp

Espace de noms: microsoft.graph

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

Créez un objet win32LobApp .

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

Requête HTTP

POST /deviceAppManagement/mobileApps

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

Le tableau suivant indique les propriétés requises lorsque vous créez l’application win32LobApp.

Propriété Type Description
id String Clé de l’entité. Cette propriété est en lecture seule. Hérité de mobileApp.
displayName String Titre de l’application, importé ou fourni par l’administrateur. Hérité de mobileApp.
description String Description de l’application. Hérité de mobileApp.
éditeur String Éditeur de l’application. Hérité de mobileApp.
largeIcon mimeContent Grande icône, à afficher dans les détails de l’application et permettant de télécharger l’icône. Hérité de mobileApp.
createdDateTime DateTimeOffset Date et heure de création de l’application. Cette propriété est en lecture seule. Hérité de mobileApp.
lastModifiedDateTime DateTimeOffset Date et heure de la dernière modification de l’application. Cette propriété est en lecture seule. Hérité de mobileApp.
isFeaturedisFeatured Booléen Valeur indiquant si l’application est marquée comme recommandée par l’administrateur- Hérité de mobileApp.
privacyInformationUrl String URL de déclaration de confidentialité. Hérité de mobileApp.
informationUrl String URL pour plus d’informations. Hérité de mobileApp.
owner String Propriétaire de l’application. Hérité de mobileApp.
developer String Développeur de l’application. Hérité de mobileApp.
notes String Notes de l’application. Hérité de mobileApp.
publishingState mobileAppPublishingState État de publication pour l’application. L’application ne peut pas être affectée, sauf si elle est publiée. Cette propriété est en lecture seule. Hérité de mobileApp. Les valeurs possibles sont notPublished, processing, published.
committedContentVersion String Version de contenu validé interne. Hérité de mobileLobApp.
fileName String Nom du fichier d’application métier principal. Hérité de mobileLobApp.
size Int64 Taille totale, tous les fichiers chargés compris. Cette propriété est en lecture seule. Hérité de mobileLobApp.
installCommandLine String Indique la ligne de commande pour installer cette application. Utilisé pour installer l’application Win32. Exemple : msiexec /i "Orca.Msi" /qn.
uninstallCommandLine String Indique la ligne de commande pour désinstaller cette application. Utilisé pour désinstaller l’application. Exemple : msiexec /x "{85F4CBCB-9BBC-4B50-A7D8-E1106771498D}" /qn.
applicableArchitectures windowsArchitecture Indique la ou les architectures Windows sur laquelle cette application doit être installée. L’application sera traitée comme ne s’applique pas aux appareils dont les architectures ne correspondent pas à la valeur sélectionnée. Lorsqu’une valeur non null est fournie pour la allowedArchitectures propriété, la valeur de la applicableArchitectures propriété est définie sur none. La valeur par défaut est none. Les valeurs possibles sont none, x86, x64. Les valeurs possibles sont : none, x86, x64, arm, neutral.
allowedArchitectures windowsArchitecture Indique la ou les architectures Windows sur laquelle cette application doit être installée. L’application sera traitée comme ne s’applique pas aux appareils dont les architectures ne correspondent pas à la valeur sélectionnée. Lorsqu’une valeur non null est fournie pour la allowedArchitectures propriété, la valeur de la applicableArchitectures propriété est définie sur none. Les valeurs possibles sont : null, x86, x64, arm64. Les valeurs possibles sont : none, x86, x64, arm, neutral.
minimumFreeDiskSpaceInMB Int32 Indique la valeur de l’espace disque disponible minimal requis pour installer cette application. Plage autorisée de 0 à driver's maximum available free space.
minimumMemoryInMB Int32 Indique la valeur de la mémoire physique minimale requise pour installer cette application. Plage autorisée de 0 à total physical memory from WMI helper.
minimumNumberOfProcessors Int32 Indique la valeur du nombre minimal de processeurs requis pour installer cette application. La valeur minimale est 0.
minimumCpuSpeedInMHz Int32 Indique la valeur de la vitesse minimale du processeur requise pour installer cette application. Plage autorisée de 0 à clock speed from WMI helper.
règles collection win32LobAppRule Indique les règles de détection et d’exigence pour cette application. Les valeurs possibles sont : Win32LobAppFileSystemRule, Win32LobAppPowerShellScriptRule, Win32LobAppProductCodeRule, Win32LobAppRegistryRule.
installExperience win32LobAppInstallExperience Indique l’expérience d’installation de cette application.
returnCodes Collection win32LobAppReturnCode Indique les codes de retour pour le comportement post-installation.
msiInformation win32LobAppMsiInformation Indique les détails MSI si cette application Win32 est une application MSI.
setupFilePath String Indique le chemin relatif du fichier d’installation dans le package Win32LobApp chiffré. Exemple : Intel-SA-00075 Detection and Mitigation Tool.msi.
minimumSupportedWindowsRelease String Indique la valeur de la version minimale de Windows prise en charge. Exemple : Windows11_23H2.

Réponse

Si elle réussit, cette méthode renvoie un 201 Created code de réponse et un objet win32LobApp dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande.

POST https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 2168

{
  "@odata.type": "#microsoft.graph.win32LobApp",
  "displayName": "Display Name value",
  "description": "Description value",
  "publisher": "Publisher value",
  "largeIcon": {
    "@odata.type": "microsoft.graph.mimeContent",
    "type": "Type value",
    "value": "dmFsdWU="
  },
  "isFeatured": true,
  "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
  "informationUrl": "https://example.com/informationUrl/",
  "owner": "Owner value",
  "developer": "Developer value",
  "notes": "Notes value",
  "publishingState": "processing",
  "committedContentVersion": "Committed Content Version value",
  "fileName": "File Name value",
  "size": 4,
  "installCommandLine": "Install Command Line value",
  "uninstallCommandLine": "Uninstall Command Line value",
  "applicableArchitectures": "x86",
  "allowedArchitectures": "x86",
  "minimumFreeDiskSpaceInMB": 8,
  "minimumMemoryInMB": 1,
  "minimumNumberOfProcessors": 9,
  "minimumCpuSpeedInMHz": 4,
  "rules": [
    {
      "@odata.type": "microsoft.graph.win32LobAppRegistryRule",
      "ruleType": "requirement",
      "check32BitOn64System": true,
      "keyPath": "Key Path value",
      "valueName": "Value Name value",
      "operationType": "exists",
      "operator": "equal",
      "comparisonValue": "Comparison Value value"
    }
  ],
  "installExperience": {
    "@odata.type": "microsoft.graph.win32LobAppInstallExperience",
    "runAsAccount": "user",
    "deviceRestartBehavior": "allow"
  },
  "returnCodes": [
    {
      "@odata.type": "microsoft.graph.win32LobAppReturnCode",
      "returnCode": 10,
      "type": "success"
    }
  ],
  "msiInformation": {
    "@odata.type": "microsoft.graph.win32LobAppMsiInformation",
    "productCode": "Product Code value",
    "productVersion": "Product Version value",
    "upgradeCode": "Upgrade Code value",
    "requiresReboot": true,
    "packageType": "perUser",
    "productName": "Product Name value",
    "publisher": "Publisher value"
  },
  "setupFilePath": "Setup File Path value",
  "minimumSupportedWindowsRelease": "Minimum Supported Windows Release value"
}

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: 2340

{
  "@odata.type": "#microsoft.graph.win32LobApp",
  "id": "9607b530-b530-9607-30b5-079630b50796",
  "displayName": "Display Name value",
  "description": "Description value",
  "publisher": "Publisher value",
  "largeIcon": {
    "@odata.type": "microsoft.graph.mimeContent",
    "type": "Type value",
    "value": "dmFsdWU="
  },
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "isFeatured": true,
  "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
  "informationUrl": "https://example.com/informationUrl/",
  "owner": "Owner value",
  "developer": "Developer value",
  "notes": "Notes value",
  "publishingState": "processing",
  "committedContentVersion": "Committed Content Version value",
  "fileName": "File Name value",
  "size": 4,
  "installCommandLine": "Install Command Line value",
  "uninstallCommandLine": "Uninstall Command Line value",
  "applicableArchitectures": "x86",
  "allowedArchitectures": "x86",
  "minimumFreeDiskSpaceInMB": 8,
  "minimumMemoryInMB": 1,
  "minimumNumberOfProcessors": 9,
  "minimumCpuSpeedInMHz": 4,
  "rules": [
    {
      "@odata.type": "microsoft.graph.win32LobAppRegistryRule",
      "ruleType": "requirement",
      "check32BitOn64System": true,
      "keyPath": "Key Path value",
      "valueName": "Value Name value",
      "operationType": "exists",
      "operator": "equal",
      "comparisonValue": "Comparison Value value"
    }
  ],
  "installExperience": {
    "@odata.type": "microsoft.graph.win32LobAppInstallExperience",
    "runAsAccount": "user",
    "deviceRestartBehavior": "allow"
  },
  "returnCodes": [
    {
      "@odata.type": "microsoft.graph.win32LobAppReturnCode",
      "returnCode": 10,
      "type": "success"
    }
  ],
  "msiInformation": {
    "@odata.type": "microsoft.graph.win32LobAppMsiInformation",
    "productCode": "Product Code value",
    "productVersion": "Product Version value",
    "upgradeCode": "Upgrade Code value",
    "requiresReboot": true,
    "packageType": "perUser",
    "productName": "Product Name value",
    "publisher": "Publisher value"
  },
  "setupFilePath": "Setup File Path value",
  "minimumSupportedWindowsRelease": "Minimum Supported Windows Release value"
}
  • Last updated on