Mettre à jour iosEasEmailProfileConfiguration
Espace de noms: microsoft.graph
Important: Les API Microsoft Graph sous la version /beta sont susceptibles d’être modifiées ; l’utilisation de production n’est pas prise en charge.
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
Mettez à jour les propriétés d’un objet iosEasEmailProfileConfiguration .
Cette API est disponible dans les déploiements de cloud national suivants.
| Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Autorisations
L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.
| Type d’autorisation | Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins) |
|---|---|
| Déléguée (compte professionnel ou scolaire) | DeviceManagementConfiguration.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. |
| Application | DeviceManagementConfiguration.ReadWrite.All |
Requête HTTP
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}
En-têtes de demande
| En-tête | Valeur |
|---|---|
| Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
| Accepter | application/json |
Corps de la demande
Dans le corps de la demande, fournissez une représentation JSON pour l’objet iosEasEmailProfileConfiguration .
Le tableau suivant présente les propriétés requises lorsque vous créez iosEasEmailProfileConfiguration.
| Propriété | Type | Description |
|---|---|---|
| id | String | Clé de l’entité. Hérité de deviceConfiguration. |
| lastModifiedDateTime | DateTimeOffset | Date et heure de dernière modification de l’objet. Hérité de deviceConfiguration. |
| roleScopeTagIds | String collection | Liste des balises d’étendue pour cette instance d’entité. Hérité de deviceConfiguration. |
| supportsScopeTags | Boolean | Indique si la configuration d’appareil sous-jacente prend en charge l’attribution des balises d’étendue. L’attribution à la propriété ScopeTags n’est pas autorisée lorsque cette valeur est false et que les entités ne sont pas visibles par les utilisateurs délimités. Cela se produit pour les stratégies héritées créées dans Silverlight et peut être résolu en supprimant et en recréant la stratégie dans le portail Azure. Cette propriété est en lecture seule. Hérité de deviceConfiguration. |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | Applicabilité de l’édition du système d’exploitation pour cette stratégie. Hérité de deviceConfiguration. |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | Règle d’applicabilité de la version du système d’exploitation pour cette stratégie. Hérité de deviceConfiguration. |
| deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | Règle d’applicabilité du mode appareil pour cette stratégie. Hérité de deviceConfiguration. |
| createdDateTime | DateTimeOffset | Date et heure de création de l’objet. Hérité de deviceConfiguration. |
| description | String | Description de la configuration de l’appareil fournie par l’administrateur. Hérité de deviceConfiguration. |
| displayName | String | Nom de la configuration de l’appareil fourni par l’administrateur. Hérité de deviceConfiguration. |
| version | Int32 | Version de la configuration de l’appareil. Hérité de deviceConfiguration. |
| usernameSource | userEmailSource | Attribut de nom d’utilisateur sélectionné à partir d’AAD et injecté dans ce profil avant l’installation sur l’appareil. Hérité de easEmailProfileConfigurationBase. Les valeurs possibles sont les suivantes : userPrincipalName, primarySmtpAddress. |
| usernameAADSource | usernameSource | Nom du champ AAD, qui sera utilisé pour récupérer le nom d’utilisateur du profil de messagerie. Hérité de easEmailProfileConfigurationBase. Les valeurs possibles sont userPrincipalName, primarySmtpAddress et samAccountName. |
| userDomainNameSource | domainNameSource | Attribut UserDomainname sélectionné dans AAD et injecté dans ce profil avant l’installation sur l’appareil. Hérité de easEmailProfileConfigurationBase. Les valeurs possibles sont les suivantes : fullDomainName, netBiosDomainName. |
| customDomainName | String | Valeur de nom de domaine personnalisé utilisée lors de la génération d’un profil de messagerie avant l’installation sur l’appareil. Hérité de easEmailProfileConfigurationBase |
| accountName | String | Nom du compte. |
| authenticationMethod | easAuthenticationMethod | Méthode d’authentification pour ce profil Email. Les valeurs possibles sont usernameAndPassword, certificate et derivedCredential. |
| blockMovingMessagesToOtherEmailAccounts | Boolean | Indique si le déplacement des messages vers d’autres comptes de messagerie doit être bloqué ou non. |
| blockSendingEmailFromThirdPartyApps | Boolean | Indique s’il faut ou non bloquer l’envoi d’e-mails à partir d’applications tierces. |
| blockSyncingRecentlyUsedEmailAddresses | Boolean | Indique s’il faut ou non bloquer la synchronisation des adresses e-mail récemment utilisées, pour instance lors de la composition d’un nouvel e-mail. |
| durationOfEmailToSync | emailSyncDuration | Durée de synchronisation de l’e-mail. . Les valeurs possibles sont les suivantes : userDefined, oneDay, threeDays, oneWeek, twoWeeks, oneMonth et unlimited. |
| emailAddressSource | userEmailSource | Email attribut sélectionné à partir d’AAD et injecté dans ce profil avant l’installation sur l’appareil. Les valeurs possibles sont les suivantes : userPrincipalName, primarySmtpAddress. |
| easServices | easServices | Échangez des données à synchroniser. Les valeurs possibles sont : none, calendars, contacts, email, notes, reminders. |
| easServicesUserOverrideEnabled | Boolean | Autoriser les utilisateurs à modifier les paramètres de synchronisation. |
| hostName | String | Emplacement Exchange auquel (URL) l’application de messagerie native se connecte. |
| requireSmime | Boolean | Indique si le certificat S/MIME doit être utilisé ou non. |
| smimeEnablePerMessageSwitch | Boolean | Indique si les e-mails non chiffrés doivent être autorisés ou non. |
| smimeEncryptByDefaultEnabled | Boolean | Si la valeur est true, le chiffrement S/MIME est activé par défaut. |
| smimeSigningEnabled | Boolean | Si la signature S/MIME est définie sur true, la signature S/MIME est activée pour ce compte |
| smimeSigningUserOverrideEnabled | Boolean | Si la valeur est true, l’utilisateur peut activer ou désactiver la connexion S/MIME. |
| smimeEncryptByDefaultUserOverrideEnabled | Boolean | Si la valeur est true, l’utilisateur peut activer le chiffrement par défaut. |
| smimeSigningCertificateUserOverrideEnabled | Boolean | Si la valeur est true, l’utilisateur peut sélectionner l’identité de signature. |
| smimeEncryptionCertificateUserOverrideEnabled | Boolean | Si la valeur est true, l’utilisateur peut sélectionner l’identité de chiffrement S/MIME. |
| requireSsl | Boolean | Indique si le protocole SSL doit être utilisé ou non. |
| useOAuth | Boolean | Spécifie si la connexion doit utiliser OAuth pour l’authentification. |
| signingCertificateType | emailCertificateType | Type de certificat de signature pour ce profil Email. Les valeurs possibles sont none, certificate et derivedCredential. |
| encryptionCertificateType | emailCertificateType | Type de certificat de chiffrement pour ce profil Email. Les valeurs possibles sont none, certificate et derivedCredential. |
| perAppVPNProfileId | String | ID de profil de la stratégie VPN Per-App à utiliser pour accéder aux e-mails à partir du client de messagerie natif |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet iosEasEmailProfileConfiguration mis à jour dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 2187
{
"@odata.type": "#microsoft.graph.iosEasEmailProfileConfiguration",
"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,
"usernameSource": "primarySmtpAddress",
"usernameAADSource": "primarySmtpAddress",
"userDomainNameSource": "netBiosDomainName",
"customDomainName": "Custom Domain Name value",
"accountName": "Account Name value",
"authenticationMethod": "certificate",
"blockMovingMessagesToOtherEmailAccounts": true,
"blockSendingEmailFromThirdPartyApps": true,
"blockSyncingRecentlyUsedEmailAddresses": true,
"durationOfEmailToSync": "oneDay",
"emailAddressSource": "primarySmtpAddress",
"easServices": "calendars",
"easServicesUserOverrideEnabled": true,
"hostName": "Host Name value",
"requireSmime": true,
"smimeEnablePerMessageSwitch": true,
"smimeEncryptByDefaultEnabled": true,
"smimeSigningEnabled": true,
"smimeSigningUserOverrideEnabled": true,
"smimeEncryptByDefaultUserOverrideEnabled": true,
"smimeSigningCertificateUserOverrideEnabled": true,
"smimeEncryptionCertificateUserOverrideEnabled": true,
"requireSsl": true,
"useOAuth": true,
"signingCertificateType": "certificate",
"encryptionCertificateType": "certificate",
"perAppVPNProfileId": "Per App VPNProfile Id value"
}
Réponse
Voici un exemple de réponse. Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2359
{
"@odata.type": "#microsoft.graph.iosEasEmailProfileConfiguration",
"id": "e03086da-86da-e030-da86-30e0da8630e0",
"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,
"usernameSource": "primarySmtpAddress",
"usernameAADSource": "primarySmtpAddress",
"userDomainNameSource": "netBiosDomainName",
"customDomainName": "Custom Domain Name value",
"accountName": "Account Name value",
"authenticationMethod": "certificate",
"blockMovingMessagesToOtherEmailAccounts": true,
"blockSendingEmailFromThirdPartyApps": true,
"blockSyncingRecentlyUsedEmailAddresses": true,
"durationOfEmailToSync": "oneDay",
"emailAddressSource": "primarySmtpAddress",
"easServices": "calendars",
"easServicesUserOverrideEnabled": true,
"hostName": "Host Name value",
"requireSmime": true,
"smimeEnablePerMessageSwitch": true,
"smimeEncryptByDefaultEnabled": true,
"smimeSigningEnabled": true,
"smimeSigningUserOverrideEnabled": true,
"smimeEncryptByDefaultUserOverrideEnabled": true,
"smimeSigningCertificateUserOverrideEnabled": true,
"smimeEncryptionCertificateUserOverrideEnabled": true,
"requireSsl": true,
"useOAuth": true,
"signingCertificateType": "certificate",
"encryptionCertificateType": "certificate",
"perAppVPNProfileId": "Per App VPNProfile Id value"
}