Compartilhar via


Criar windowsUniversalAppX

Namespace: microsoft.graph

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

Cria um novo objeto windowsUniversalAppX.

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 da solicitação, forneça uma representação JSON do objeto windowsUniversalAppX.

A tabela a seguir mostra as propriedades obrigatórias ao criar windowsUniversalAppX.

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
applicableArchitectures windowsArchitecture As arquiteturas do Windows nas quais este aplicativo pode ser executado. Os valores possíveis são: , , , , arm, neutral; o valor predefinido é none. x64x86none Os valores possíveis são: none, x86, x64, arm, neutral.
applicableDeviceTypes windowsDeviceType Os tipos de dispositivos Windows nos quais este aplicativo pode ser executado. Os valores possíveis são: , , , , holographic, team; o valor predefinido é none. mobiledesktopnone Os valores possíveis são: none, desktop, mobile, holographic, team, unknownFutureValue.
identityName Cadeia de caracteres O Nome da Identidade da aplicação, analisado a partir do ficheiro appx quando é carregado através do Intune consola MEM. Por exemplo: "Contoso.DemoApp".
identityPublisherHash Cadeia de caracteres O Hash do Editor de Identidade da aplicação, analisado a partir do ficheiro appx quando é carregado através do Intune consola MEM. Por exemplo: "AB82CD0XYZ".
identityResourceIdentifier Cadeia de caracteres O Identificador de Recurso de Identidade da aplicação, analisado a partir do ficheiro appx quando é carregado através do Intune consola MEM. Por exemplo: "TestResourceId".
isBundle Boolean Se o aplicativo é um pacote ou não. Se FOR VERDADEIRO, a aplicação é um grupo; se FOR FALSO, a aplicação não é um pacote.
minimumSupportedOperatingSystem windowsMinimumOperatingSystem O valor do sistema operativo Windows mínimo aplicável.
identityVersion Cadeia de caracteres A Versão de Identidade da aplicação, analisada a partir do ficheiro appx quando é carregada através do Intune consola MEM. Por exemplo: "1.0.0.0".

Resposta

Se bem-sucedido, este método retornará um código de resposta 201 Created e um objeto windowsUniversalAppX 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: 1189

{
  "@odata.type": "#microsoft.graph.windowsUniversalAppX",
  "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,
  "applicableArchitectures": "x86",
  "applicableDeviceTypes": "desktop",
  "identityName": "Identity Name value",
  "identityPublisherHash": "Identity Publisher Hash value",
  "identityResourceIdentifier": "Identity Resource Identifier value",
  "isBundle": true,
  "minimumSupportedOperatingSystem": {
    "@odata.type": "microsoft.graph.windowsMinimumOperatingSystem",
    "v8_0": true,
    "v8_1": true,
    "v10_0": true
  },
  "identityVersion": "Identity Version 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: 1361

{
  "@odata.type": "#microsoft.graph.windowsUniversalAppX",
  "id": "4bc47eba-7eba-4bc4-ba7e-c44bba7ec44b",
  "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,
  "applicableArchitectures": "x86",
  "applicableDeviceTypes": "desktop",
  "identityName": "Identity Name value",
  "identityPublisherHash": "Identity Publisher Hash value",
  "identityResourceIdentifier": "Identity Resource Identifier value",
  "isBundle": true,
  "minimumSupportedOperatingSystem": {
    "@odata.type": "microsoft.graph.windowsMinimumOperatingSystem",
    "v8_0": true,
    "v8_1": true,
    "v10_0": true
  },
  "identityVersion": "Identity Version value"
}