deploymentAudience : updateAudience

Espace de noms : microsoft.graph.windowsUpdates

Important

Les API sous la /beta version de Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur de version .

Mettre à jour les collections de membres et d’exclusions d’un deploymentAudience.

L’ajout d’un objet azureADDevice aux membres ou aux collections d’exclusions d’une audience de déploiement crée automatiquement un objet Azure AD appareil, s’il n’existe pas déjà.

Si le même updatableAsset est inclus dans les collections d’exclusions et de membres d’un deploymentAudience, le déploiement ne s’applique pas à ce bien.

Si tous les objets updatableAsset sont du même type, vous pouvez également utiliser la méthode updateAudienceById pour mettre à jour deploymentAudience.

Notes

Cette API présente un problème connu lié aux déploiements créés via Intune.

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) WindowsUpdates.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application WindowsUpdates.ReadWrite.All

Requête HTTP

POST /admin/windows/updates/deployments/{deploymentId}/audience/updateAudience

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON des paramètres.

Le tableau suivant indique les paramètres utilisables avec cette action.

Paramètre Type Description
addMembers collection microsoft.graph.windowsUpdates.updatableAsset Liste des ressources updatableAsset à ajouter en tant que membres de l’audience de déploiement.
removeMembers collection microsoft.graph.windowsUpdates.updatableAsset Liste des ressources à supprimer en tant que membres de l’audience de déploiement.
addExclusions collection microsoft.graph.windowsUpdates.updatableAsset Liste des ressources à ajouter en tant qu’exclusions de l’audience de déploiement.
removeExclusions collection microsoft.graph.windowsUpdates.updatableAsset Liste des ressources à supprimer en tant qu’exclusions de l’audience de déploiement.

Réponse

Si elle réussit, cette action renvoie un code de réponse 202 Accepted. Elle ne renvoie rien dans le corps de la réponse.

Exemples

Demande

POST https://graph.microsoft.com/beta/admin/windows/updates/deployments/{deploymentId}/audience/updateAudience
Content-Type: application/json

{
  "addMembers": [
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    }
  ],
  "removeMembers": [
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    }
  ],
  "addExclusions": [
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    }
  ],
  "removeExclusions": [
    {
      "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
      "id": "String (identifier)"
    }
  ]
}

Réponse

HTTP/1.1 202 Accepted