Uppdatera en konfigurationsprincip för den angivna kunden

Artikel
09/11/2024

Gäller för: Partnercenter

Så här uppdaterar du den angivna konfigurationsprincipen för den angivna kunden.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och app+användarautentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du upp Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID:t (customer-tenant-id).
Principidentifieraren.

C#

Om du vill uppdatera en befintlig konfigurationsprincip för den angivna kunden instansierar du ett nytt ConfigurationPolicy-objekt enligt följande kodfragment. Värdena i det här nya objektet ersätter motsvarande värden i det befintliga objektet. Anropa sedan metoden IAggregatePartner.Customers.ById med kund-ID:t för att hämta ett gränssnitt för åtgärder på den angivna kunden. Anropa sedan metoden ConfigurationPolicies.ById med princip-ID:t för att hämta ett gränssnitt för konfigurationsprincipåtgärder för den angivna principen. Anropa slutligen metoden Patch eller PatchAsync för att uppdatera konfigurationsprincipen.

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);

Exempel: Konsoltestapp. Projekt: Exempelklass för Partnercenter SDK: UpdateConfigurationPolicy.cs

REST-begäran

Begärandesyntax

Metod	URI för förfrågan
PUT	{baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1

URI-parameter

Använd följande sökvägsparametrar när du skapar begäran.

Namn	Typ	Obligatorisk	Beskrivning
kund-ID	sträng	Ja	En GUID-formaterad sträng som identifierar kunden.
policy-id	sträng	Ja	En GUID-formaterad sträng som identifierar principen som ska uppdateras.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Begärandetexten måste innehålla ett -objekt som innehåller principinformationen.

Namn	Typ	Obligatorisk	Uppdateringsbar	Description
id	sträng	Ja	Nej	Den GUID-formaterade strängen som identifierar principen.
name	sträng	Ja	Ja	Det egna namnet på principen.
category	sträng	Ja	Nej	Principkategorin.
beskrivning	sträng	No	Ja	Principbeskrivningen.
devicesAssigned	antal	Nej	Nej	Antalet enheter.
policyInställningar	matris med strängar	Ja	Ja	Principinställningarna: "none","remove_oem_preinstalls","oobe_user_not_local_admin","skip_express_settings","skip _oem_registration,"skip_eula".

Exempel på begäran

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

REST-svar

Om det lyckas innehåller svarstexten ConfigurationPolicy-resursen för den nya principen.

Lyckade svar och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckat eller misslyckat och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Partnercenter REST-felkoder.

Exempel på svar

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

Dela via