Compartilhar via


Atualizar androidGeneralDeviceConfiguration

Namespace: microsoft.graph

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

Atualizar as propriedades de um objeto androidGeneralDeviceConfiguration.

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA 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
Delegado (conta pessoal da Microsoft) Sem suporte.
Application DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}

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

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

Propriedade Tipo Descrição
id String Chave da entidade. Herdada de deviceConfiguration
lastModifiedDateTime DateTimeOffset DateTime da última modificação do objeto. Herdada de deviceConfiguration
createdDateTime DateTimeOffset DateTime em que o objeto foi criado. Herdada de deviceConfiguration
description String O administrador forneceu a descrição da Configuração do dispositivo. Herdada de deviceConfiguration
displayName String O administrador forneceu o nome da Configuração do dispositivo. Herdada de deviceConfiguration
versão Int32 Versão da configuração do dispositivo. Herdada de deviceConfiguration
appsBlockClipboardSharing Boolean Indica se a função de copiar e colar entre aplicativos será bloqueada ou não no compartilhamento de área de transferência.
appsBlockCopyPaste Boolean Indica se a função de copiar e colar dentro de aplicativos será bloqueada ou não.
appsBlockYouTube Boolean Indica se o aplicativo YouTube deve ou não ser bloqueado.
bluetoothBlocked Boolean Indica se o Bluetooth deve ou não ser bloqueado.
cameraBlocked Boolean Indica se o uso da câmera deve ou não ser bloqueado.
cellularBlockDataRoaming Boolean Indica se o roaming de dados deve ou não ser bloqueado.
cellularBlockMessaging Boolean Indica se as mensagens SMS/MMS devem ou não ser bloqueadas.
cellularBlockVoiceRoaming Boolean Indica se o roaming de voz deve ou não ser bloqueado.
cellularBlockWiFiTethering Boolean Indica se a sincronização de compartilhamento de Internet por Wi-Fi deve ou não ser bloqueada.
compliantAppsList Coleção appListItem Lista de aplicativos em conformidade (lista de permissões ou lista de bloqueios, controladas por CompliantAppListType). Essa coleção pode conter um máximo de 10.000 elementos.
compliantAppListType appListType Tipo de lista que está em CompliantAppsList. Os valores possíveis são: none, appsInListCompliant, appsNotInListCompliant.
diagnosticDataBlockSubmission Boolean Indica se o envio de dados de diagnóstico deve ou não ser bloqueado.
locationServicesBlocked Boolean Indica se os serviços de localização devem ou não ser bloqueados.
googleAccountBlockAutoSync Boolean Indica se a sincronização automática da conta do Google deve ou não ser bloqueada.
googlePlayStoreBlocked Boolean Indica se a Google Play Store deve ou não ser bloqueada.
kioskModeBlockSleepButton Boolean Indica se o botão de suspensão de tela deve ou não ser bloqueado no modo quiosque.
kioskModeBlockVolumeButtons Boolean Indica se os botões de volume devem ou não ser bloqueados no modo quiosque.
kioskModeApps Coleção appListItem Uma lista de aplicativos que poderão ser executados quando o dispositivo estiver no modo quiosque. Esta coleção pode conter um máximo de 500 elementos.
nfcBlocked Boolean Indica se a comunicação a curta distância deve ou não ser bloqueada.
passwordBlockFingerprintUnlock Boolean Indica se o desbloqueio de impressão digital deve ou não ser bloqueado.
passwordBlockTrustAgents Boolean Indica se o Smart Lock e outros agentes confiáveis devem ou não ser bloqueados.
passwordExpirationDays Int32 Número de dias antes da expiração da senha. Valores válidos de 1 a 365
passwordMinimumLength Int32 Comprimento mínimo das senhas. Valores válidos de 4 a 16
passwordMinutesOfInactivityBeforeScreenTimeout Int32 Minutos de inatividade antes que a tela atinja o tempo limite.
passwordPreviousPasswordBlockCount Int32 Número de senhas anteriores para bloquear. Valores válidos de 0 a 24
passwordSignInFailureCountBeforeFactoryReset Int32 Número permitido de falhas de entrada antes da redefinição de fábrica. Valores válidos de 1 a 16
passwordRequiredType androidRequiredPasswordType Tipo de senha necessário. Os valores possíveis são: deviceDefault, alphabetic, alphanumeric, alphanumericWithSymbols, lowSecurityBiometric, numeric, numericComplex, any.
passwordRequired Boolean Indica se uma senha deve ou não ser exigida.
powerOffBlocked Boolean Indica se o desligamento do dispositivo deve ou não ser bloqueado.
factoryResetBlocked Boolean Indica se o usuário será ou não impedido de executar uma restauração de fábrica.
screenCaptureBlocked Boolean Indica se capturas de tela devem ou não ser bloqueadas.
deviceSharingAllowed Boolean Indica se o modo de compartilhamento do dispositivo deve ou não ser permitido.
storageBlockGoogleBackup Boolean Indica se o Backup do Google deve ou não ser bloqueado.
storageBlockRemovableStorage Boolean Indica se o uso do armazenamento removível deve ou não ser bloqueado.
storageRequireDeviceEncryption Boolean Indica se a criptografia do dispositivo é ou não necessária.
storageRequireRemovableStorageEncryption Boolean Indica se a criptografia do armazenamento removível é ou não necessária.
voiceAssistantBlocked Boolean Indica se o uso do Assistente de voz será ou não bloqueado.
voiceDialingBlocked Boolean Indica se a discagem de voz deve ou não ser bloqueada.
webBrowserBlockPopups Boolean Indica se os pop-ups dentro do navegador da Web devem ou não ser bloqueados.
webBrowserBlockAutofill Boolean Indica se o recurso de preenchimento automático do navegador da Web deve ou não ser bloqueado.
webBrowserBlockJavaScript Boolean Indica se o JavaScript dentro do navegador da Web deve ou não ser bloqueado.
webBrowserBlocked Boolean Indica se o navegador da Web deve ou não ser bloqueado.
webBrowserCookieSettings webBrowserCookieSettings Configuração de cookies do navegador da Web. Os valores possíveis são: browserDefault, blockAlways, allowCurrentWebSite, allowFromWebsitesVisited, allowAlways.
wiFiBlocked Boolean Indica se a sincronização de Wi-Fi deve ou não ser bloqueada.
appsInstallAllowList Coleção appListItem Lista de aplicativos que podem ser instalados no dispositivo KNOX. Esta coleção pode conter um máximo de 500 elementos.
appsLaunchBlockList Coleção appListItem Lista de aplicativos que não podem ser abertos no dispositivo KNOX. Esta coleção pode conter um máximo de 500 elementos.
appsHideList Coleção appListItem Lista de aplicativos que devem ficar ocultos no dispositivo KNOX. Esta coleção pode conter um máximo de 500 elementos.
securityRequireVerifyApps Boolean Exige que o recurso de verificação de aplicativos Android esteja ativado.

Resposta

Se tiver êxito, este método retornará o código de resposta 200 OK e um objeto androidGeneralDeviceConfiguration atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 3033

{
  "@odata.type": "#microsoft.graph.androidGeneralDeviceConfiguration",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "appsBlockClipboardSharing": true,
  "appsBlockCopyPaste": true,
  "appsBlockYouTube": true,
  "bluetoothBlocked": true,
  "cameraBlocked": true,
  "cellularBlockDataRoaming": true,
  "cellularBlockMessaging": true,
  "cellularBlockVoiceRoaming": true,
  "cellularBlockWiFiTethering": true,
  "compliantAppsList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "compliantAppListType": "appsInListCompliant",
  "diagnosticDataBlockSubmission": true,
  "locationServicesBlocked": true,
  "googleAccountBlockAutoSync": true,
  "googlePlayStoreBlocked": true,
  "kioskModeBlockSleepButton": true,
  "kioskModeBlockVolumeButtons": true,
  "kioskModeApps": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "nfcBlocked": true,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockTrustAgents": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "alphabetic",
  "passwordRequired": true,
  "powerOffBlocked": true,
  "factoryResetBlocked": true,
  "screenCaptureBlocked": true,
  "deviceSharingAllowed": true,
  "storageBlockGoogleBackup": true,
  "storageBlockRemovableStorage": true,
  "storageRequireDeviceEncryption": true,
  "storageRequireRemovableStorageEncryption": true,
  "voiceAssistantBlocked": true,
  "voiceDialingBlocked": true,
  "webBrowserBlockPopups": true,
  "webBrowserBlockAutofill": true,
  "webBrowserBlockJavaScript": true,
  "webBrowserBlocked": true,
  "webBrowserCookieSettings": "blockAlways",
  "wiFiBlocked": true,
  "appsInstallAllowList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "appsLaunchBlockList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "appsHideList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "securityRequireVerifyApps": 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: 3205

{
  "@odata.type": "#microsoft.graph.androidGeneralDeviceConfiguration",
  "id": "9e00d534-d534-9e00-34d5-009e34d5009e",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "appsBlockClipboardSharing": true,
  "appsBlockCopyPaste": true,
  "appsBlockYouTube": true,
  "bluetoothBlocked": true,
  "cameraBlocked": true,
  "cellularBlockDataRoaming": true,
  "cellularBlockMessaging": true,
  "cellularBlockVoiceRoaming": true,
  "cellularBlockWiFiTethering": true,
  "compliantAppsList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "compliantAppListType": "appsInListCompliant",
  "diagnosticDataBlockSubmission": true,
  "locationServicesBlocked": true,
  "googleAccountBlockAutoSync": true,
  "googlePlayStoreBlocked": true,
  "kioskModeBlockSleepButton": true,
  "kioskModeBlockVolumeButtons": true,
  "kioskModeApps": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "nfcBlocked": true,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockTrustAgents": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "alphabetic",
  "passwordRequired": true,
  "powerOffBlocked": true,
  "factoryResetBlocked": true,
  "screenCaptureBlocked": true,
  "deviceSharingAllowed": true,
  "storageBlockGoogleBackup": true,
  "storageBlockRemovableStorage": true,
  "storageRequireDeviceEncryption": true,
  "storageRequireRemovableStorageEncryption": true,
  "voiceAssistantBlocked": true,
  "voiceDialingBlocked": true,
  "webBrowserBlockPopups": true,
  "webBrowserBlockAutofill": true,
  "webBrowserBlockJavaScript": true,
  "webBrowserBlocked": true,
  "webBrowserCookieSettings": "blockAlways",
  "wiFiBlocked": true,
  "appsInstallAllowList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "appsLaunchBlockList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "appsHideList": [
    {
      "@odata.type": "microsoft.graph.appListItem",
      "name": "Name value",
      "publisher": "Publisher value",
      "appStoreUrl": "https://example.com/appStoreUrl/",
      "appId": "App Id value"
    }
  ],
  "securityRequireVerifyApps": true
}