Compartilhar via

Criar win32LobApp

Namespace: microsoft.graph

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Crie um novo objeto win32LobApp .

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ✅

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Application DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All

Solicitação HTTP

POST /deviceAppManagement/mobileApps

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar application/json

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON para o objeto win32LobApp.

A tabela seguinte mostra as propriedades necessárias quando cria o win32LobApp.

Propriedade Tipo Descrição
id String Chave da entidade. Essa propriedade é somente leitura. Herdado de mobileApp
displayName String O título do aplicativo importado ou definido pelo administrador. Herdado de mobileApp
description String A descrição do aplicativo. Herdado de mobileApp
publicador String O publicador do aplicativo. Herdado de mobileApp
largeIcon mimeContent O ícone grande, a ser exibido nos detalhes do aplicativo e usado para o carregamento do ícone. Herdado de mobileApp
createdDateTime DateTimeOffset A data e a hora da criação do aplicativo. Essa propriedade é somente leitura. Herdado de mobileApp
lastModifiedDateTime DateTimeOffset A data e a hora que o aplicativo foi modificado pela última vez. Essa propriedade é somente leitura. Herdado de mobileApp
isFeatured Boolean O valor que indica se o aplicativo está marcado como em destaque pelo administrador. Herdado de mobileApp
privacyInformationUrl String A URL da declaração de privacidade. Herdado de mobileApp
informationUrl String A URL de informações adicionais. Herdado de mobileApp
owner String O proprietário do conteúdo. Herdado de mobileApp
developer String O desenvolvedor do aplicativo. Herdado de mobileApp
notes String Anotações do aplicativo. Herdado de mobileApp
publishingState mobileAppPublishingState O estado de publicação do aplicativo. O aplicativo não pode ser assinado, a menos que ele seja publicado. Essa propriedade é somente leitura. Herdado do mobileApp. Os valores possíveis são: notPublished, processing, published.
committedContentVersion String A versão do conteúdo interno confirmado. Herdado de mobileLobApp
fileName String O nome do arquivo do aplicativo Lob principal. Herdado de mobileLobApp
size Int64 O tamanho total, incluindo todos os arquivos carregados. Essa propriedade é somente leitura. Herdado de mobileLobApp
installCommandLine Cadeia de caracteres Indica a linha de comandos para instalar esta aplicação. Utilizado para instalar a aplicação Win32. Exemplo: msiexec /i "Orca.Msi" /qn.
desinstalarComandoLine Cadeia de caracteres Indica a linha de comandos para desinstalar esta aplicação. Utilizado para desinstalar a aplicação. Exemplo: msiexec /x "{85F4CBCB-9BBC-4B50-A7D8-E1106771498D}" /qn.
applicableArchitectures windowsArchitecture Indica as arquiteturas do Windows em que esta aplicação deve ser instalada. A aplicação será tratada como não aplicável para dispositivos com arquiteturas que não correspondam ao valor selecionado. Quando é fornecido um valor não nulo para a allowedArchitectures propriedade, o valor da applicableArchitectures propriedade é definido como none. O valor padrão é none. Os valores possíveis são: none, x86, x64. Os valores possíveis são: none, x86, x64, arm, neutral.
allowedArchitectures windowsArchitecture Indica as arquiteturas do Windows em que esta aplicação deve ser instalada. A aplicação será tratada como não aplicável para dispositivos com arquiteturas que não correspondam ao valor selecionado. Quando é fornecido um valor não nulo para a allowedArchitectures propriedade, o valor da applicableArchitectures propriedade é definido como none. Os valores possíveis são: null, x86, x64, arm64. Os valores possíveis são: none, x86, x64, arm, neutral.
minimumFreeDiskSpaceInMB Int32 Indica o valor do espaço mínimo livre em disco necessário para instalar esta aplicação. Intervalo permitido de 0 a driver's maximum available free space.
minimumMemoryInMB Int32 Indica o valor da memória física mínima necessária para instalar esta aplicação. Intervalo permitido de 0 a total physical memory from WMI helper.
minimumNumberOfProcessors Int32 Indica o valor para o número mínimo de processadores que é necessário para instalar esta aplicação. O valor mínimo é 0.
minimumCpuSpeedInMHz Int32 Indica o valor da velocidade mínima da CPU necessária para instalar esta aplicação. Intervalo permitido de 0 a clock speed from WMI helper.
regras coleção win32LobAppRule Indica as regras de deteção e requisitos para esta aplicação. Os valores possíveis são: Win32LobAppFileSystemRule, Win32LobAppPowerShellScriptRule, Win32LobAppProductCodeRule, Win32LobAppRegistryRule.
installExperience win32LobAppInstallExperience Indica a experiência de instalação desta aplicação.
returnCodes coleção win32LobAppReturnCode Indica os códigos de retorno para o comportamento pós-instalação.
msiInformation win32LobAppMsiInformation Indica os detalhes do MSI se esta aplicação Win32 for uma aplicação MSI.
setupFilePath Cadeia de caracteres Indica o caminho relativo do ficheiro de configuração no pacote Win32LobApp encriptado. Exemplo: Intel-SA-00075 Detection and Mitigation Tool.msi.
minimumSupportedWindowsRelease Cadeia de caracteres Indica o valor da versão mínima suportada do Windows. Exemplo: Windows11_23H2.

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto win32LobApp no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

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

Resposta

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada 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