Atualizar androidEasEmailProfileConfiguration

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para o uso de produção.

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

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.
Aplicativo	DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{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 para o objeto androidEasEmailProfileConfiguration .

A tabela a seguir mostra as propriedades necessárias ao criar o androidEasEmailProfileConfiguration.

Propriedade	Tipo	Descrição
id	String	Chave da entidade. Herdada de deviceConfiguration
lastModifiedDateTime	DateTimeOffset	DateTime da última modificação do objeto. Herdada de deviceConfiguration
roleScopeTagIds	Coleção de cadeias de caracteres	Lista de Marcas de Escopo para esta instância de Entidade. Herdada de deviceConfiguration
supportsScopeTags	Booliano	Indica se a Configuração do Dispositivo subjacente dá suporte ou não à atribuição de marcas de escopo. A atribuição à propriedade ScopeTags não é permitida quando esse valor é falso e as entidades não estarão visíveis para usuários com escopo. Isso ocorre para políticas herdadas criadas no Silverlight e podem ser resolvidas excluindo e recriando a política no Portal do Azure. Essa propriedade é somente leitura. Herdada de deviceConfiguration
deviceManagementApplicabilityRuleOsEdition	deviceManagementApplicabilityRuleOsEdition	A aplicabilidade da edição do sistema operacional para esta Política. Herdada de deviceConfiguration
deviceManagementApplicabilityRuleOsVersion	deviceManagementApplicabilityRuleOsVersion	A regra de aplicabilidade da versão do sistema operacional para esta Política. Herdada de deviceConfiguration
deviceManagementApplicabilityRuleDeviceMode	deviceManagementApplicabilityRuleDeviceMode	A regra de aplicabilidade do modo de dispositivo para esta Política. 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
accountName	Cadeia de caracteres	Exchange ActiveSync nome da conta, exibido aos usuários como nome do perfil EAS (este).
Authenticationmethod	easAuthenticationMethod	Método de autenticação para Exchange ActiveSync. Os valores possíveis são: usernameAndPassword, certificate, derivedCredential.
syncCalendar	Booliano	Alterna sincronizando o calendário. Se definido como calendário falso for desativado no dispositivo.
syncContacts	Booliano	Alterna contatos de sincronização. Se definido como contatos falsos, serão desativados no dispositivo.
syncTasks	Booliano	Alterna tarefas de sincronização. Se definido como tarefas falsas, serão desativadas no dispositivo.
syncNotes	Booliano	Alterna notas de sincronização. Se definido como notas falsas, será desativado no dispositivo.
durationOfEmailToSync	emailSyncDuration	O email de duração do tempo deve ser sincronizado. Os valores possíveis são: userDefined, oneDay, threeDays, oneWeek, twoWeeks, oneMonth, unlimited.
emailAddressSource	userEmailSource	Email atributo que é escolhido do AAD e injetado nesse perfil antes de instalar no dispositivo. Os valores possíveis são: userPrincipalName e primarySmtpAddress.
emailSyncSchedule	emailSyncSchedule	Email agenda de sincronização. Os valores possíveis são: userDefined, asMessagesArrive, manual, fifteenMinutes, thirtyMinutes, sixtyMinutes, basedOnMyUsage.
hostName	Cadeia de caracteres	Local de troca (URL) ao qual o aplicativo de email nativo se conecta.
requireSmime	Booliano	Indica se deve ou não usar o certificado S/MIME.
Requiressl	Booliano	Indica se deve ou não usar o SSL.
usernameSource	androidUsernameSource	Atributo de nome de usuário que é escolhido do AAD e injetado nesse perfil antes de instalar no dispositivo. Os valores possíveis são: username, userPrincipalName, samAccountName, primarySmtpAddress.
userDomainNameSource	domainNameSource	Atributo UserDomainname que é escolhido do AAD e injetado nesse perfil antes de instalar no dispositivo. Os valores possíveis são: fullDomainName e netBiosDomainName.
customDomainName	Cadeia de caracteres	Valor de nome de domínio personalizado usado durante a geração de um perfil de email antes de instalar no dispositivo.

Resposta

Se for bem-sucedido, esse método retornará um 200 OK código de resposta e um objeto androidEasEmailProfileConfiguration atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 1566

{
  "@odata.type": "#microsoft.graph.androidEasEmailProfileConfiguration",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "accountName": "Account Name value",
  "authenticationMethod": "certificate",
  "syncCalendar": true,
  "syncContacts": true,
  "syncTasks": true,
  "syncNotes": true,
  "durationOfEmailToSync": "oneDay",
  "emailAddressSource": "primarySmtpAddress",
  "emailSyncSchedule": "asMessagesArrive",
  "hostName": "Host Name value",
  "requireSmime": true,
  "requireSsl": true,
  "usernameSource": "userPrincipalName",
  "userDomainNameSource": "netBiosDomainName",
  "customDomainName": "Custom Domain Name 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 200 OK
Content-Type: application/json
Content-Length: 1738

{
  "@odata.type": "#microsoft.graph.androidEasEmailProfileConfiguration",
  "id": "ee5e5610-5610-ee5e-1056-5eee10565eee",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "accountName": "Account Name value",
  "authenticationMethod": "certificate",
  "syncCalendar": true,
  "syncContacts": true,
  "syncTasks": true,
  "syncNotes": true,
  "durationOfEmailToSync": "oneDay",
  "emailAddressSource": "primarySmtpAddress",
  "emailSyncSchedule": "asMessagesArrive",
  "hostName": "Host Name value",
  "requireSmime": true,
  "requireSsl": true,
  "usernameSource": "userPrincipalName",
  "userDomainNameSource": "netBiosDomainName",
  "customDomainName": "Custom Domain Name value"
}