Compartir a través de

Creación de win32LobApp

Espacio de nombres: microsoft.graph

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Cree un nuevo objeto win32LobApp .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ✅ ✅ ✅

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All

Solicitud HTTP

POST /deviceAppManagement/mobileApps

Encabezados de solicitud

Encabezado Valor
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Aceptar application/json

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON para el objeto win32LobApp.

En la tabla siguiente se muestran las propiedades necesarias al crear win32LobApp.

Propiedad Tipo Descripción
id Cadena Clave de la entidad. Esta propiedad es de sólo lectura. Heredado de mobileApp.
displayName Cadena Título de la aplicación importado o proporcionado por el administrador. Heredado de mobileApp.
description Cadena Descripción de la aplicación. Heredado de mobileApp.
publicador Cadena Publicador de la aplicación. Heredado de mobileApp.
largeIcon mimeContent Icono grande que se mostrará en los detalles de la aplicación y se usa para cargar el icono. Heredado de mobileApp.
createdDateTime DateTimeOffset Fecha y hora de creación de la aplicación. Esta propiedad es de sólo lectura. Heredado de mobileApp.
lastModifiedDateTime DateTimeOffset Fecha y hora de la última modificación de la aplicación. Esta propiedad es de sólo lectura. Heredado de mobileApp.
isFeatured Booleano Valor que indica si el administrador ha marcado la aplicación como destacada. Heredado de mobileApp.
privacyInformationUrl Cadena Dirección URL de la declaración de privacidad. Heredado de mobileApp.
informationUrl Cadena Dirección URL para obtener más información. Heredado de mobileApp.
owner Cadena Propietario de la aplicación. Heredado de mobileApp.
developer Cadena Desarrollador de la aplicación. Heredado de mobileApp.
notas Cadena Notas de la aplicación. Heredado de mobileApp.
publishingState mobileAppPublishingState Estado de publicación de la aplicación. La aplicación no puede asignarse a menos que se publique. Esta propiedad es de sólo lectura. Se hereda de mobileApp. Los valores posibles son: notPublished, processing, published.
committedContentVersion Cadena Versión interna del contenido confirmado. Heredado de mobileLobApp.
fileName Cadena Nombre del archivo de la aplicación de LOB principal. Heredado de mobileLobApp.
size Int64 Tamaño total, incluidos todos los archivos cargados. Esta propiedad es de sólo lectura. Heredado de mobileLobApp.
installCommandLine Cadena Indica la línea de comandos para instalar esta aplicación. Se usa para instalar la aplicación Win32. Ejemplo: msiexec /i "Orca.Msi" /qn.
uninstallCommandLine Cadena Indica la línea de comandos para desinstalar esta aplicación. Se usa para desinstalar la aplicación. Ejemplo: msiexec /x "{85F4CBCB-9BBC-4B50-A7D8-E1106771498D}" /qn.
applicableArchitectures windowsArchitecture Indica las arquitecturas de Windows en las que se debe instalar esta aplicación. La aplicación se tratará como no aplicable para dispositivos con arquitecturas que no coincidan con el valor seleccionado. Cuando se proporciona un valor que no es NULL para la allowedArchitectures propiedad , el valor de la applicableArchitectures propiedad se establece en none. El valor predeterminado es none. Los valores posibles son: none, x86, x64. Los valores posibles son: none, x86, x64, arm, neutral.
allowedArchitectures windowsArchitecture Indica las arquitecturas de Windows en las que se debe instalar esta aplicación. La aplicación se tratará como no aplicable para dispositivos con arquitecturas que no coincidan con el valor seleccionado. Cuando se proporciona un valor que no es NULL para la allowedArchitectures propiedad , el valor de la applicableArchitectures propiedad se establece en none. Los valores posibles son: null, x86, x64 y arm64 Los valores posibles son: none, x86, x64, arm, neutral.
minimumFreeDiskSpaceInMB Int32 Indica el valor del espacio en disco libre mínimo necesario para instalar esta aplicación. Intervalo permitido de 0 a driver's maximum available free space.
minimumMemoryInMB Int32 Indica el valor de la memoria física mínima necesaria para instalar esta aplicación. Intervalo permitido de 0 a total physical memory from WMI helper.
minimumNumberOfProcessors Int32 Indica el valor del número mínimo de procesadores necesarios para instalar esta aplicación. El valor mínimo es 0.
minimumCpuSpeedInMHz Int32 Indica el valor de la velocidad mínima de CPU necesaria para instalar esta aplicación. Intervalo permitido de 0 a clock speed from WMI helper.
reglas Colección win32LobAppRule Indica las reglas de detección y requisitos de esta aplicación. Los valores posibles son: Win32LobAppFileSystemRule, Win32LobAppPowerShellScriptRule, Win32LobAppProductCodeRule, Win32LobAppRegistryRule.
installExperience win32LobAppInstallExperience Indica la experiencia de instalación de esta aplicación.
returnCodes Colección win32LobAppReturnCode Indica los códigos de retorno para el comportamiento posterior a la instalación.
msiInformation win32LobAppMsiInformation Indica los detalles de MSI si esta aplicación Win32 es una aplicación MSI.
setupFilePath Cadena Indica la ruta de acceso relativa del archivo de instalación en el paquete Win32LobApp cifrado. Ejemplo: Intel-SA-00075 Detection and Mitigation Tool.msi.
minimumSupportedWindowsRelease Cadena Indica el valor de la versión mínima admitida de Windows. Ejemplo: Windows11_23H2.

Respuesta

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto win32LobApp en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

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"
}

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.

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