Mettre à jour une stratégie de configuration pour le client spécifié

Article
09/11/2024

S’applique à : Espace partenaires

Comment mettre à jour la stratégie de configuration spécifiée pour le client spécifié.

Prérequis

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec des informations d’identification d’application autonome et d’application+utilisateur.
ID du client (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace partenaires en sélectionnant l’espace de travail Clients , puis le client dans la liste des clients, puis Compte. Dans la page Compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client . L’ID Microsoft est le même que l’ID de client (customer-tenant-id).
Identificateur de stratégie.

C#

Pour mettre à jour une stratégie de configuration existante pour le client spécifié, instanciez un nouvel objet ConfigurationPolicy , comme indiqué dans l’extrait de code suivant. Les valeurs de ce nouvel objet remplacent les valeurs correspondantes dans l’objet existant. Ensuite, appelez la méthode IAggregatePartner.Customers.ById avec l’ID client pour récupérer une interface permettant d’effectuer des opérations sur le client spécifié. Ensuite, appelez la méthode ConfigurationPolicies.ById avec l’ID de stratégie pour récupérer une interface pour les opérations de stratégie de configuration pour la stratégie spécifiée. Enfin, appelez la méthode Patch ou PatchAsync pour mettre à jour la stratégie de configuration.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedConfigurationPolicyId;

ConfigurationPolicy configPolicyToBeUpdated = new ConfigurationPolicy()
{
    Name= "Test Config Policy",
    Id = selectedConfigurationPolicyId,
    PolicySettings = new List<PolicySettingsType>() {
        PolicySettingsType.OobeUserNotLocalAdmin,
        PolicySettingsType.RemoveOemPreinstalls }
};

ConfigurationPolicy updatedConfigurationPolicy =
    partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.ById(selectedConfigurationPolicyId).Patch(configPolicyToBeUpdated);

Exemple : application de test console. Projet : Classe d’exemples sdk de l’Espace partenaires : UpdateConfigurationPolicy.cs

Demande REST

Syntaxe de la requête

Méthode	URI de demande
PUT	{baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1

Paramètre d’URI

Utilisez les paramètres de chemin d’accès suivants lors de la création de la demande.

Nom	Type	Obligatoire	Description
customer-id	string	Oui	Chaîne au format GUID qui identifie le client.
id de stratégie	string	Oui	Chaîne au format GUID qui identifie la stratégie à mettre à jour.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de demande

Le corps de la requête doit contenir un objet qui fournit les informations de stratégie.

Nom	Type	Obligatoire	Peut être mise à jour	Description
id	string	Oui	Non	Chaîne au format GUID qui identifie la stratégie.
name	string	Oui	Oui	Nom convivial de la stratégie.
catégorie	string	Oui	Non	Catégorie de stratégie.
description	string	Non	Oui	Description de la stratégie.
devicesAssigned	nombre	Non	Non	Nombre d’appareils.
policySettings	tableau de chaînes	Oui	Oui	Les paramètres de stratégie : « none », « remove_oem_preinstalls », « oobe_user_not_local_admin », « skip_express_settings », « skip _oem_registration, « skip_eula ».

Exemple de requête

PUT https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/policies/56edf752-ee77-4fd8-b7f5-df1f74a3a9ac HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Length: 256
Content-Type: application/json
Host: api.partnercenter.microsoft.com

{
    "id": "56edf752-ee77-4fd8-b7f5-df1f74a3a9ac",
    "name": "Windows test policy",
    "category": "o_o_b_e",
    "description": "Test policy creation from API",
    "devicesAssigned": 0,
    "policySettings": ["skip_express_settings"]
}

Réponse REST

En cas de réussite, le corps de la réponse contient la ressource ConfigurationPolicy pour la nouvelle stratégie.

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Exemple de réponse

HTTP/1.1 200 OK
Content-Length: 421
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cb1fa1f3-1381-45d9-99c5-511e5d3efa7c
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:10:29 GMT

{
    "id": "56edf752-ee77-4fd8-b7f5-df1f74a3a9ac",
    "name": "Windows test policy",
    "category": "o_o_b_e",
    "description": "Test policy creation from API",
    "devicesAssigned": 0,
    "policySettings": ["skip_express_settings"],
    "createdDate": "2017-01-01T00:00:00",
    "lastModifiedDate": "2017-07-25T18:10:15",
    "attributes": {
        "objectType": "ConfigurationPolicy"
    }
}

Partager via