Mettre à jour une stratégie de configuration pour le client spécifiéUpdate a configuration policy for the specified customer

S’applique àApplies To

  • Espace partenairesPartner Center
  • Espace partenaires de Microsoft Cloud GermanyPartner Center for Microsoft Cloud Germany

Comment mettre à jour la stratégie de configuration spécifiée pour le client spécifié.How to update the specified configuration policy for the specified customer.

PrérequisPrerequisites

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires.Credentials as described in Partner Center authentication. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application autonome et de l’application + utilisateur.This scenario supports authentication with both standalone App and App+User credentials.

  • ID du client (customer-tenant-id).A customer ID (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans le tableau de bord de l’Espace partenaires.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Sélectionnez CSP dans le menu Espace partenaires, puis Clients.Select CSP from the Partner Center menu, followed by Customers. Sélectionnez le client dans la liste des clients, puis Compte.Select the customer from the customer list, then select Account. Dans la page compte du client, recherchez l' ID Microsoft dans la section informations sur le compte client .On the customer's Account page, look for the Microsoft ID in the Customer Account Info section. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • Identificateur de la stratégie.The policy identifier.

C#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.To update an existing configuration policy for the specified customer, instantiate a new ConfigurationPolicy object as shown in the following code snippet. Les valeurs de ce nouvel objet remplacent les valeurs correspondantes dans l’objet existant.The values in this new object replace the corresponding values in the existing object. Ensuite, appelez la méthode collection iaggregatepartner. Customers. méthode BYID avec l’ID client pour récupérer une interface pour les opérations sur le client spécifié.Then, call the IAggregatePartner.Customers.ById method with the customer ID to retrieve an interface to operations on the specified customer. Ensuite, appelez la méthode ConfigurationPolicies. méthode 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.Next, call the ConfigurationPolicies.ById method with the policy ID to retrieve an interface to configuration policy operations for the specified policy. Enfin, appelez la méthode patch ou PatchAsync pour mettre à jour la stratégie de configuration.Finally, call the Patch or PatchAsync method to update the configuration policy.

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.Sample: Console test app. Projet: classe d’exemples du kit de développement logiciel (SDK) Partner Center : UpdateConfigurationPolicy.csProject: Partner Center SDK Samples Class: UpdateConfigurationPolicy.cs

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
PUTPUT {baseURL}/v1/Customers/{Customer-ID}/Policies/{Policy-ID} http/1.1{baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1

Paramètre d’URIURI parameter

Utilisez les paramètres de chemin d’accès suivants lors de la création de la demande.Use the following path parameters when creating the request.

NomName TypeType ObligatoireRequired DescriptionDescription
customer-idcustomer-id stringstring OuiYes Chaîne au format GUID qui identifie le client.A GUID-formatted string that identifies the customer.
ID de stratégiepolicy-id stringstring OuiYes Chaîne au format GUID qui identifie la stratégie à mettre à jour.A GUID-formatted string that identifies the policy to update.

En-têtes de requêteRequest headers

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.For more information, see Partner Center REST headers.

Corps de demandeRequest body

Le corps de la demande doit contenir un objet qui fournit les informations de stratégie.The request body must contain an object that provides the policy information.

NomName TypeType ObligatoireRequired Peut être mise à jourUpdatable DescriptionDescription
idid stringstring OuiYes NonNo Chaîne au format GUID qui identifie la stratégie.The GUID-formatted string that identifies the policy.
namename stringstring OuiYes OuiYes Nom convivial de la stratégie.The friendly name of the policy.
catégoriecategory stringstring OuiYes NonNo Catégorie de stratégie.The policy category.
descriptiondescription stringstring NonNo OuiYes Description de la stratégie.The policy description.
devicesAssigneddevicesAssigned nombrenumber NonNo NonNo Nombre d’appareils.The number of devices.
policySettingspolicySettings tableau de chaînesarray of strings OuiYes OuiYes Les paramètres de stratégie : « aucun », « supprimer les _ _ préinstallations OEM », _ « _ l’utilisateur OOBE n’est pas _ _ administrateur local », « ignorer les _ _ paramètres Express », « ignorer _ _ l’inscription OEM », ignorer le _ CLUF.The policy settings: "none","remove_oem_preinstalls","oobe_user_not_local_admin","skip_express_settings","skip _oem_registration,"skip_eula".

Exemple de requêteRequest example

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: de894e18-f027-4ac0-8b5a-34f0c222af0c
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 RESTREST response

En cas de réussite, le corps de la réponse contient la ressource ConfigurationPolicy pour la nouvelle stratégie.If successful, the response body contains the ConfigurationPolicy resource for the new policy.

Codes d’erreur et de réussite de la réponseResponse success and error codes

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.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires.Use a network trace tool to read this code, error type, and additional parameters. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.For the full list, see Partner Center REST error codes.

Exemple de réponseResponse example

HTTP/1.1 200 OK
Content-Length: 421
Content-Type: application/json; charset=utf-8
MS-CorrelationId: f9fd5973-6ad8-4585-aadc-f2b0443fe27b
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"
    }
}