Mettre à jour deviceManagementTemplate
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 deviceManagementTemplate .
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/templates/{deviceManagementTemplateId}
PATCH /deviceManagement/templates/{deviceManagementTemplateId}/migratableTo/{deviceManagementTemplateId}
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 deviceManagementTemplate .
Le tableau suivant indique les propriétés requises lorsque vous créez le deviceManagementTemplate.
Propriété | Type | Description |
---|---|---|
id | String | ID du modèle |
displayName | String | Nom d’affichage du modèle |
description | String | Description du modèle |
versionInfo | String | Informations de version du modèle |
isDeprecated | Boolean | Le modèle est déconseillé ou non. Les intentions ne peuvent pas être créées à partir d’un modèle déconseillé. |
intentCount | Int32 | Nombre d’intentions créées à partir de ce modèle. |
templateType | deviceManagementTemplateType | Type du modèle. Les valeurs possibles sont les suivantes : securityBaseline , specializedDevices , advancedThreatProtectionSecurityBaseline , deviceConfiguration , custom , securityTemplate , microsoftEdgeSecurityBaseline , microsoftOffice365ProPlusSecurityBaseline , deviceCompliance , deviceConfigurationForOffice365 , cloudPC et firewallSharedSettings . |
platformType | policyPlatformType | Plateforme du modèle. Les valeurs possibles sont les suivantes : android , androidForWork , iOS , macOS , windowsPhone81 , windows81AndLater , windows10AndLater , androidWorkProfile , windows10XProfile et all . |
templateSubtype | deviceManagementTemplateSubtype | Sous-type du modèle. Les valeurs possibles sont les suivantes : none , firewall , diskEncryption , attackSurfaceReduction , endpointDetectionReponse , accountProtection , antivirus , firewallSharedAppList , firewallSharedIpList et firewallSharedPortlist . |
publishedDateTime | DateTimeOffset | Quand le modèle a été publié |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK
code de réponse et un objet deviceManagementTemplate mis à jour dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
PATCH https://graph.microsoft.com/beta/deviceManagement/templates/{deviceManagementTemplateId}
Content-type: application/json
Content-length: 405
{
"@odata.type": "#microsoft.graph.deviceManagementTemplate",
"displayName": "Display Name value",
"description": "Description value",
"versionInfo": "Version Info value",
"isDeprecated": true,
"intentCount": 11,
"templateType": "specializedDevices",
"platformType": "androidForWork",
"templateSubtype": "firewall",
"publishedDateTime": "2016-12-31T23:58:16.1180489-08:00"
}
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: 454
{
"@odata.type": "#microsoft.graph.deviceManagementTemplate",
"id": "edd764ca-64ca-edd7-ca64-d7edca64d7ed",
"displayName": "Display Name value",
"description": "Description value",
"versionInfo": "Version Info value",
"isDeprecated": true,
"intentCount": 11,
"templateType": "specializedDevices",
"platformType": "androidForWork",
"templateSubtype": "firewall",
"publishedDateTime": "2016-12-31T23:58:16.1180489-08:00"
}