Criar macOSLobApp

Artigo
12/08/2021
4 minutos para o fim da leitura

Namespace: microsoft.graph

Importante: As GRAPH da Microsoft na versão /beta estão sujeitas a alterações; o uso de produção não é suportado.

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

Pré-requisitos

Uma das seguintes permissões é obrigató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)	DeviceManagementApps.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	DeviceManagementApps.ReadWrite.All

Solicitação HTTP

POST /deviceAppManagement/mobileApps

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	<Token> de portador obrigatório.
Aceitar	application/json

Corpo da solicitação

No corpo da solicitação, fornece uma representação JSON para o objeto macOSLobApp.

A tabela a seguir mostra as propriedades que são necessárias ao criar o macOSLobApp.

Propriedade	Tipo	Descrição
id	String	Chave da entidade. 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. Herdado de mobileApp
lastModifiedDateTime	DateTimeOffset	A data e a hora que o aplicativo foi modificado pela última vez. 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
proprietário	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
uploadState	Int32	O estado de carregamento. Os valores possíveis são: 0 - `Not Ready` , 1 - `Ready` , 2 - `Processing` . 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. Herdado de mobileApp. Os valores possíveis são: `notPublished`, `processing`, `published`.
isAssigned	Boolean	O valor que indica se o aplicativo é atribuído a pelo menos um grupo. Herdado de mobileApp
roleScopeTagIds	Coleção String	Lista de ids de marca de escopo para este aplicativo móvel. Herdado de mobileApp
dependentAppCount	Int32	O número total de dependências que o aplicativo filho tem. Herdado de mobileApp
supersedingAppCount	Int32	O número total de aplicativos que esse aplicativo sobressede direta ou indiretamente. Herdado de mobileApp
supersededAppCount	Int32	O número total de aplicativos pelos quais esse aplicativo é, direta ou indiretamente, é suplido. Herdado de mobileApp
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. Herdado de mobileLobApp
bundleId	String	A ID do pacote.
minimumSupportedOperatingSystem	macOSMinimumOperatingSystem	O valor do sistema de operacional mínimo aplicável.
buildNumber	String	O número de composição do aplicativo MacOS Line of Business (LoB).
versionNumber	String	O número de versão do aplicativo MacOS Line of Business (LoB).
childApps	Coleção macOSLobChildApp	A lista de aplicativos neste pacote de pacotes
identityVersion	String	A versão da identidade.
md5HashChunkSize	Int32	O tamanho da parte do hash MD5
md5Hash	Coleção String	Os códigos de hash MD5
ignoreVersionDetection	Boolean	Um booliano para controlar se a versão do aplicativo será usada para detectar o aplicativo depois que ele for instalado em um dispositivo. Defina isso como true para aplicativos macOS Line of Business (LoB) que usam um recurso de atualização automática.
installAsManaged	Boolean	Um booleano para controlar se o aplicativo será instalado como gerenciado (exige macOS 11.0 e outras restrições de PKG).

Resposta

Se tiver êxito, este método retornará um código 201 Created de resposta e um objeto macOSLobApp no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 1742

{
  "@odata.type": "#microsoft.graph.macOSLobApp",
  "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",
  "uploadState": 11,
  "publishingState": "processing",
  "isAssigned": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "dependentAppCount": 1,
  "supersedingAppCount": 3,
  "supersededAppCount": 2,
  "committedContentVersion": "Committed Content Version value",
  "fileName": "File Name value",
  "size": 4,
  "bundleId": "Bundle Id value",
  "minimumSupportedOperatingSystem": {
    "@odata.type": "microsoft.graph.macOSMinimumOperatingSystem",
    "v10_7": true,
    "v10_8": true,
    "v10_9": true,
    "v10_10": true,
    "v10_11": true,
    "v10_12": true,
    "v10_13": true,
    "v10_14": true,
    "v10_15": true,
    "v11_0": true,
    "v12_0": true
  },
  "buildNumber": "Build Number value",
  "versionNumber": "Version Number value",
  "childApps": [
    {
      "@odata.type": "microsoft.graph.macOSLobChildApp",
      "bundleId": "Bundle Id value",
      "buildNumber": "Build Number value",
      "versionNumber": "Version Number value"
    }
  ],
  "identityVersion": "Identity Version value",
  "md5HashChunkSize": 0,
  "md5Hash": [
    "Md5Hash value"
  ],
  "ignoreVersionDetection": true,
  "installAsManaged": true
}

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

{
  "@odata.type": "#microsoft.graph.macOSLobApp",
  "id": "7be9250a-250a-7be9-0a25-e97b0a25e97b",
  "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",
  "uploadState": 11,
  "publishingState": "processing",
  "isAssigned": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "dependentAppCount": 1,
  "supersedingAppCount": 3,
  "supersededAppCount": 2,
  "committedContentVersion": "Committed Content Version value",
  "fileName": "File Name value",
  "size": 4,
  "bundleId": "Bundle Id value",
  "minimumSupportedOperatingSystem": {
    "@odata.type": "microsoft.graph.macOSMinimumOperatingSystem",
    "v10_7": true,
    "v10_8": true,
    "v10_9": true,
    "v10_10": true,
    "v10_11": true,
    "v10_12": true,
    "v10_13": true,
    "v10_14": true,
    "v10_15": true,
    "v11_0": true,
    "v12_0": true
  },
  "buildNumber": "Build Number value",
  "versionNumber": "Version Number value",
  "childApps": [
    {
      "@odata.type": "microsoft.graph.macOSLobChildApp",
      "bundleId": "Bundle Id value",
      "buildNumber": "Build Number value",
      "versionNumber": "Version Number value"
    }
  ],
  "identityVersion": "Identity Version value",
  "md5HashChunkSize": 0,
  "md5Hash": [
    "Md5Hash value"
  ],
  "ignoreVersionDetection": true,
  "installAsManaged": true
}

Criar macOSLobApp

Pré-requisitos

Solicitação HTTP

Cabeçalhos de solicitação

Corpo da solicitação

Resposta

Exemplo

Solicitação

Resposta

Comentários