Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante: Microsoft admite Intune API /beta, pero están sujetas a cambios más frecuentes. Microsoft recomienda usar la versión v1.0 siempre que sea posible. Compruebe la disponibilidad de una API en la versión v1.0 mediante el selector de versiones.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Actualice las propiedades de un objeto androidEasEmailProfileConfiguration .
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permisos
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | DeviceManagementConfiguration.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | DeviceManagementConfiguration.ReadWrite.All |
Solicitud HTTP
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}
Encabezados de solicitud
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Aceptar | application/json |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON para el objeto androidEasEmailProfileConfiguration .
En la tabla siguiente se muestran las propiedades necesarias al crear androidEasEmailProfileConfiguration.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Clave de la entidad. Heredado de deviceConfiguration |
| lastModifiedDateTime | DateTimeOffset | Fecha y hora en la que se modificó el objeto por última vez. Heredado de deviceConfiguration |
| roleScopeTagIds | Colección string | Lista de etiquetas de ámbito para esta instancia de entity. Heredado de deviceConfiguration |
| supportsScopeTags | Booleano | Indica si la configuración de dispositivo subyacente admite o no la asignación de etiquetas de ámbito. No se permite asignar a la propiedad ScopeTags cuando este valor es false y las entidades no serán visibles para los usuarios con ámbito. Esto ocurre para las directivas heredadas creadas en Silverlight y se pueden resolver mediante la eliminación y la recreación de la directiva en el portal de Azure. Esta propiedad es de sólo lectura. Heredado de deviceConfiguration |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | Aplicabilidad de la edición del sistema operativo para esta directiva. Heredado de deviceConfiguration |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | Regla de aplicabilidad de la versión del sistema operativo para esta directiva. Heredado de deviceConfiguration |
| deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | Regla de aplicabilidad del modo de dispositivo para esta directiva. Heredado de deviceConfiguration |
| createdDateTime | DateTimeOffset | Fecha y hora en la que se creó el objeto. Heredado de deviceConfiguration |
| description | Cadena | Descripción proporcionada por el administrador de la configuración del dispositivo. Heredado de deviceConfiguration |
| displayName | Cadena | Nombre proporcionado por el administrador de la configuración del dispositivo. Heredado de deviceConfiguration |
| version | Int32 | Versión de la configuración del dispositivo. Heredado de deviceConfiguration |
| accountName | Cadena | Exchange ActiveSync nombre de cuenta, que se muestra a los usuarios como nombre del perfil eas (este). |
| authenticationMethod | easAuthenticationMethod | Método de autenticación para Exchange ActiveSync. Los valores posibles son: usernameAndPassword, certificate, derivedCredential. |
| syncCalendar | Booleano | Alterna la sincronización del calendario. Si se establece en false calendar está desactivado en el dispositivo. |
| syncContacts | Booleano | Alterna la sincronización de contactos. Si se establece en contactos falsos, se desactivan en el dispositivo. |
| syncTasks | Booleano | Alterna las tareas de sincronización. Si se establece en tareas falsas, se desactivan en el dispositivo. |
| syncNotes | Booleano | Alterna las notas de sincronización. Si se establece en notas falsas, se desactivan en el dispositivo. |
| durationOfEmailToSync | emailSyncDuration | Duración del tiempo con el que se debe sincronizar el correo electrónico. Los valores posibles son: userDefined, oneDay, threeDays, oneWeek, twoWeeks, oneMonth y unlimited. |
| emailAddressSource | userEmailSource | Email atributo que se selecciona de AAD y se inserta en este perfil antes de instalarlo en el dispositivo. Los valores posibles son: userPrincipalName, primarySmtpAddress. |
| emailSyncSchedule | emailSyncSchedule | Email programación de sincronización. Los valores posibles son: userDefined, asMessagesArrive, manual, fifteenMinutes, thirtyMinutes, sixtyMinutes y basedOnMyUsage. |
| hostName | Cadena | Ubicación de Exchange (DIRECCIÓN URL) a la que se conecta la aplicación de correo nativa. |
| requireSmime | Booleano | Indica si se va a usar o no el certificado S/MIME. |
| requireSsl | Booleano | Indica si se va a usar SSL o no. |
| usernameSource | androidUsernameSource | Atributo username que se selecciona de AAD y se inserta en este perfil antes de instalarlo en el dispositivo. Los valores posibles son: username, userPrincipalName, samAccountName y primarySmtpAddress |
| userDomainNameSource | domainNameSource | Atributo UserDomainname que se selecciona de AAD y se inserta en este perfil antes de instalarlo en el dispositivo. Los valores posibles son: fullDomainName, netBiosDomainName. |
| customDomainName | Cadena | Valor de nombre de dominio personalizado que se usa al generar un perfil de correo electrónico antes de instalarlo en el dispositivo. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto androidEasEmailProfileConfiguration actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
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"
}
Respuesta
Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada 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"
}