Compartilhar via


Atualizar macOSLobApp

Namespace: microsoft.graph

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

Atualize as propriedades de um objeto macOSLobApp .

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) DeviceManagementApps.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Application DeviceManagementApps.ReadWrite.All

Solicitação HTTP

PATCH /deviceAppManagement/mobileApps/{mobileAppId}

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

A tabela seguinte mostra as propriedades necessárias quando cria 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
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. 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. Herdado de mobileLobApp
bundleId Cadeia de caracteres O bundleId principal do pacote.
minimumSupportedOperatingSystem macOSMinimumOperatingSystem ComplexType macOSMinimumOperatingSystem que indica o sistema operativo mínimo aplicável à aplicação.
buildNumber Cadeia de caracteres O número de compilação do pacote. Isto deve corresponder ao pacote CFBundleShortVersionString do ficheiro .pkg.
versionNumber Cadeia de caracteres O número da versão do pacote. Isto deve corresponder ao pacote CFBundleVersion no ficheiro packageinfo.
childApps coleção macOSLobChildApp Lista de objetos ComplexType macOSLobChildApp. Representa as aplicações que se espera que sejam instaladas pelo pacote.
md5HashChunkSize Int32 O tamanho do segmento do hash MD5. Isto é "0" ou está vazio se o pacote tiver sido carregado diretamente. Se a Ferramenta de Encapsulamento de Aplicações do Intune for utilizada para criar um .intunemac, este valor pode ser encontrado dentro do ficheiro Detection.xml.
md5Hash String collection Os códigos hash MD5. Isto está vazio se o pacote tiver sido carregado diretamente. Se a Ferramenta de Encapsulamento de Aplicações do Intune for utilizada para criar um .intunemac, este valor pode ser encontrado dentro do ficheiro Detection.xml.
ignoreVersionDetection Booliano Quando VERDADEIRO, indica que a versão da aplicação NÃO será utilizada para detetar se a aplicação está instalada num dispositivo. Quando FALSO, indica que a versão da aplicação será utilizada para detetar se a aplicação está instalada num dispositivo. Defina como verdadeiro para as aplicações que utilizam uma funcionalidade de atualização automática.
installAsManaged Booliano Quando VERDADEIRO, indica que a aplicação será instalada como gerida (requer o macOS 11.0 e outras restrições de pacotes geridos). Quando FALSO, indica que a aplicação será instalada como não gerida.

Resposta

Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto macOSLobApp atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}
Content-type: application/json
Content-length: 1523

{
  "@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",
  "publishingState": "processing",
  "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,
    "v13_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"
    }
  ],
  "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 200 OK
Content-Type: application/json
Content-Length: 1695

{
  "@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",
  "publishingState": "processing",
  "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,
    "v13_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"
    }
  ],
  "md5HashChunkSize": 0,
  "md5Hash": [
    "Md5Hash value"
  ],
  "ignoreVersionDetection": true,
  "installAsManaged": true
}