Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Important: Microsoft prend en charge les API Intune /beta, mais elles sont sujettes à des modifications plus fréquentes. Microsoft recommande d’utiliser la version v1.0 si possible. Vérifiez la disponibilité d’une API dans la version v1.0 à l’aide du sélecteur de version.
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
Mettez à jour les propriétés d’un objet windowsQualityUpdateCatalogItem .
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/windowsUpdateCatalogItems/{windowsUpdateCatalogItemId}
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 windowsQualityUpdateCatalogItem .
Le tableau suivant indique les propriétés requises lorsque vous créez l’objet windowsQualityUpdateCatalogItem.
| Propriété | Type | Description |
|---|---|---|
| id | String | ID de l’élément de catalogue. Héritée de windowsUpdateCatalogItem |
| displayName | String | Nom complet de l’élément de catalogue. Héritée de windowsUpdateCatalogItem |
| releaseDateTime | DateTimeOffset | Date de publication de l’élément de catalogue Hérité de windowsUpdateCatalogItem |
| endOfSupportDate | DateTimeOffset | Dernière date prise en charge pour un élément de catalogue Hérité de windowsUpdateCatalogItem |
| kbArticleId | String | Identifie l’article base de connaissances associé à l’élément de catalogue de mise à jour de qualité Windows. Lecture seule |
| classification | windowsQualityUpdateCategory | Catégorie de la mise à jour de qualité Windows. Les valeurs possibles sont : all, security, nonSecurity. En lecture seule. Les valeurs possibles sont : all, security, nonSecurity, unknownFutureValue, quickMachineRecovery. |
| qualityUpdateCadence | windowsQualityUpdateCadence | Cadence de publication de la mise à jour qualité. Les valeurs possibles sont : monthly, outOfBand. Cette propriété ne peut pas être modifiée et est automatiquement remplie lors de la création du catalogue. En lecture seule. Les valeurs possibles sont monthly, outOfBand, unknownFutureValue. |
| isExpeditable | Booléen | Si la valeur est TRUE, indique que les mises à jour qualité sont éligibles pour l’expédition. Si la valeur est FALSE, indique que les mises à jour qualité ne sont pas de qualité pour l’expédition. La valeur par défaut est FALSE. Lecture seule |
| productRevisions | collection windowsQualityUpdateCatalogProductRevision | Révisions du produit du système d’exploitation qui sont publiées dans le cadre de cette mise à jour qualité. En lecture seule. |
| cveSeverityInformation | windowsQualityUpdateCveSeverityInformation | Informations CVE pour les éléments du catalogue |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet windowsQualityUpdateCatalogItem mis à jour dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
PATCH https://graph.microsoft.com/beta/deviceManagement/windowsUpdateCatalogItems/{windowsUpdateCatalogItemId}
Content-type: application/json
Content-length: 1595
{
"@odata.type": "#microsoft.graph.windowsQualityUpdateCatalogItem",
"displayName": "Display Name value",
"releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
"endOfSupportDate": "2017-01-01T00:02:08.3437725-08:00",
"kbArticleId": "Kb Article Id value",
"classification": "security",
"qualityUpdateCadence": "outOfBand",
"isExpeditable": true,
"productRevisions": [
{
"@odata.type": "microsoft.graph.windowsQualityUpdateCatalogProductRevision",
"displayName": "Display Name value",
"releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
"versionName": "Version Name value",
"productName": "Product Name value",
"osBuild": {
"@odata.type": "microsoft.graph.windowsQualityUpdateProductBuildVersionDetail",
"majorVersionNumber": 2,
"minorVersionNumber": 2,
"buildNumber": 11,
"updateBuildRevision": 3
},
"knowledgeBaseArticle": {
"@odata.type": "microsoft.graph.windowsQualityUpdateProductKnowledgeBaseArticle",
"articleId": "Article Id value",
"articleUrl": "https://example.com/articleUrl/"
}
}
],
"cveSeverityInformation": {
"@odata.type": "microsoft.graph.windowsQualityUpdateCveSeverityInformation",
"maxSeverityLevel": "important",
"maxBaseScore": 4.0,
"exploitedCves": [
{
"@odata.type": "microsoft.graph.windowsQualityUpdateCveDetail",
"cveNumber": "Cve Number value",
"cveInformationUrl": "https://example.com/cveInformationUrl/"
}
]
}
}
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: 1644
{
"@odata.type": "#microsoft.graph.windowsQualityUpdateCatalogItem",
"id": "8eb831ba-31ba-8eb8-ba31-b88eba31b88e",
"displayName": "Display Name value",
"releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
"endOfSupportDate": "2017-01-01T00:02:08.3437725-08:00",
"kbArticleId": "Kb Article Id value",
"classification": "security",
"qualityUpdateCadence": "outOfBand",
"isExpeditable": true,
"productRevisions": [
{
"@odata.type": "microsoft.graph.windowsQualityUpdateCatalogProductRevision",
"displayName": "Display Name value",
"releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
"versionName": "Version Name value",
"productName": "Product Name value",
"osBuild": {
"@odata.type": "microsoft.graph.windowsQualityUpdateProductBuildVersionDetail",
"majorVersionNumber": 2,
"minorVersionNumber": 2,
"buildNumber": 11,
"updateBuildRevision": 3
},
"knowledgeBaseArticle": {
"@odata.type": "microsoft.graph.windowsQualityUpdateProductKnowledgeBaseArticle",
"articleId": "Article Id value",
"articleUrl": "https://example.com/articleUrl/"
}
}
],
"cveSeverityInformation": {
"@odata.type": "microsoft.graph.windowsQualityUpdateCveSeverityInformation",
"maxSeverityLevel": "important",
"maxBaseScore": 4.0,
"exploitedCves": [
{
"@odata.type": "microsoft.graph.windowsQualityUpdateCveDetail",
"cveNumber": "Cve Number value",
"cveInformationUrl": "https://example.com/cveInformationUrl/"
}
]
}
}