deploymentAudience: updateAudienceById

Cette page est-elle utile ?

D'autres commentaires ?

Les commentaires seront envoyés à Microsoft : en appuyant sur le bouton envoyer, vos commentaires seront utilisés pour améliorer les produits et services Microsoft. Politique de confidentialité.

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

HTTP

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"
  ]
}

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var memberEntityType = "String";

var addMembers = new List<String>()
{
    "String"
};

var removeMembers = new List<String>()
{
    "String"
};

var addExclusions = new List<String>()
{
    "String"
};

var removeExclusions = new List<String>()
{
    "String"
};

await graphClient.Admin.Windows.Updates.Deployments["{windowsUpdates.deployment-id}"].Audience
    .UpdateAudienceById(memberEntityType,addMembers,removeMembers,addExclusions,removeExclusions)
    .Request()
    .PostAsync();

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const updateAudienceById = {
  memberEntityType: 'String',
  addMembers: [
    'String'
  ],
  removeMembers: [
    'String'
  ],
  addExclusions: [
    'String'
  ],
  removeExclusions: [
    'String'
  ]
};

await client.api('/admin/windows/updates/deployments/{deploymentId}/audience/updateAudienceById')
    .version('beta')
    .post(updateAudienceById);

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

Objective-C

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/admin/windows/updates/deployments/{deploymentId}/audience/updateAudienceById"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

NSMutableDictionary *payloadDictionary = [[NSMutableDictionary alloc] init];

NSString *memberEntityType = @"String";
payloadDictionary[@"memberEntityType"] = memberEntityType;

NSMutableArray *addMembersList = [[NSMutableArray alloc] init];
[addMembersList addObject: @"String"];
payloadDictionary[@"addMembers"] = addMembersList;

NSMutableArray *removeMembersList = [[NSMutableArray alloc] init];
[removeMembersList addObject: @"String"];
payloadDictionary[@"removeMembers"] = removeMembersList;

NSMutableArray *addExclusionsList = [[NSMutableArray alloc] init];
[addExclusionsList addObject: @"String"];
payloadDictionary[@"addExclusions"] = addExclusionsList;

NSMutableArray *removeExclusionsList = [[NSMutableArray alloc] init];
[removeExclusionsList addObject: @"String"];
payloadDictionary[@"removeExclusions"] = removeExclusionsList;

NSData *data = [NSJSONSerialization dataWithJSONObject:payloadDictionary options:kNilOptions error:&error];
[urlRequest setHTTPBody:data];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

String memberEntityType = "String";

LinkedList<String> addMembersList = new LinkedList<String>();
addMembersList.add("String");

LinkedList<String> removeMembersList = new LinkedList<String>();
removeMembersList.add("String");

LinkedList<String> addExclusionsList = new LinkedList<String>();
addExclusionsList.add("String");

LinkedList<String> removeExclusionsList = new LinkedList<String>();
removeExclusionsList.add("String");

graphClient.admin().windows().updates().deployments("{deploymentId}").audience()
    .updateAudienceById(DeploymentAudienceUpdateAudienceByIdParameterSet
        .newBuilder()
        .withMemberEntityType(memberEntityType)
        .withAddMembers(addMembersList)
        .withRemoveMembers(removeMembersList)
        .withAddExclusions(addExclusionsList)
        .withRemoveExclusions(removeExclusionsList)
        .build())
    .buildRequest()
    .post();

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

Activer

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.New()
memberEntityType := "String"
requestBody.SetMemberEntityType(&memberEntityType)
requestBody.SetAddMembers( []String {
    "String",
}
requestBody.SetRemoveMembers( []String {
    "String",
}
requestBody.SetAddExclusions( []String {
    "String",
}
requestBody.SetRemoveExclusions( []String {
    "String",
}
deploymentId := "deployment-id"
graphClient.Admin().Windows().Updates().DeploymentsById(&deploymentId).Audience().UpdateAudienceById(deployment-id).Post(requestBody)

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

PowerShell

Import-Module Microsoft.Graph.WindowsUpdates

$params = @{
    MemberEntityType = "String"
    AddMembers = @(
        "String"
    )
    RemoveMembers = @(
        "String"
    )
    AddExclusions = @(
        "String"
    )
    RemoveExclusions = @(
        "String"
    )
}

Update-MgWindowsUpdatesDeploymentAudienceById -DeploymentId $deploymentId -BodyParameter $params

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

Réponse

HTTP/1.1 202 Accepted