deploymentAudience: updateAudienceById

Espace de noms : microsoft.graph.windowsUpdates

Important

Les API sous /beta la version dans Microsoft Graph sont sujettes à modification. 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 la version 1.0, utilisez le sélecteur de version.

Mettez à jour les collections de membres et d’exclusions d’un deploymentAudience avec des ressources updatableAsset du même type.

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.

Vous pouvez également utiliser la méthode updateAudience 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/updateAudienceById

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
memberEntityType Chaîne Type complet des ressources à même d’être mis à l’actif. Les valeurs possibles sont les suivantes : #microsoft.graph.windowsUpdates.azureADDevice, #microsoft.graph.windowsUpdates.updatableAssetGroup.
addMembers Collection de chaînes Liste des identificateurs correspondant aux ressources à ajouter en tant que membres de l’audience de déploiement.
removeMembers Collection de chaînes Liste des identificateurs correspondant aux ressources à supprimer en tant que membres de l’audience de déploiement.
addExclusions String collection Liste des identificateurs correspondant aux ressources à ajouter en tant qu’exclusions de l’audience de déploiement.
removeExclusions String collection Liste des identificateurs correspondant aux 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/updateAudienceById
Content-Type: application/json

{
  "memberEntityType": "String",
  "addMembers": [
    "String"
  ],
  "removeMembers": [
    "String"
  ],
  "addExclusions": [
    "String"
  ],
  "removeExclusions": [
    "String"
  ]
}

Réponse

HTTP/1.1 202 Accepted