Konfigurációs szabályzat frissítése a megadott ügyfélnél

A következőre vonatkozik: Partnerközpont

A megadott ügyfél konfigurációs szabályzatának frissítése.

Előfeltételek

• Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja a különálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.

• Ügyfél-azonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából az ügyféllistából, majd a Fiók lehetőség kiválasztásával. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

• A szabályzat azonosítója.

C#

A megadott ügyfél meglévő konfigurációs szabályzatának frissítéséhez hozzon létre egy új ConfigurationPolicy objektumot az alábbi kódrészletben látható módon. Az új objektum értékei lecserélik a meglévő objektum megfelelő értékeit. Ezután hívja meg az IAggregatePartner.Customers.ById metódust az ügyfél-azonosítóval, hogy lekérjen egy felületet a megadott ügyfél műveleteihez. Ezután hívja meg a ConfigurationPolicies.ById metódust a szabályzatazonosítóval, hogy lekérjen egy felületet a megadott szabályzat konfigurációs szabályzatműveleteihez. Végül hívja meg a Patch vagy a PatchAsync metódust a konfigurációs szabályzat frissítéséhez.

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

Minta: Konzolteszt alkalmazás. Projekt: Partnerközpont SDK-minták osztálya: UpdateConfigurationPolicy.cs

REST-kérelem

Kérés szintaxisa

Metódus	Kérés URI-ja
PUT	{baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1

URI-paraméter

A kérés létrehozásakor használja az alábbi elérésiút-paramétereket.

Név	Típus	Kötelező	Leírás
ügyfél-azonosító	sztring	Igen	Egy GUID formátumú sztring, amely azonosítja az ügyfelet.
policy-id	sztring	Igen	Egy GUID formátumú sztring, amely azonosítja a frissíteni kívánt szabályzatot.

Kérésfejlécek

További információ: Partnerközpont REST-fejlécei.

A kérés törzse

A kérelem törzsének tartalmaznia kell egy objektumot, amely a szabályzattal kapcsolatos információkat tartalmazza.

Név	Típus	Kötelező	Frissíthető	Leírás
id	sztring	Igen	Nem	A szabályzatot azonosító GUID formátumú sztring.
name	sztring	Igen	Yes	A szabályzat rövid neve.
category	sztring	Igen	Nem	A szabályzatkategória.
leírás	sztring	No	Igen	A szabályzat leírása.
devicesAssigned	szám	Nem	Nem	Az eszközök száma.
policySettings	sztringek tömbje	Igen	Yes	A szabályzatbeállítások: "none","remove_oem_preinstalls","oobe_user_not_local_admin","skip_express_settings","skip _oem_registration,"skip_eula".

Példa kérésre

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-válasz

Ha sikerült, a válasz törzse tartalmazza az új szabályzat ConfigurationPolicy erőforrását.

Sikeres válasz és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. Használja a hálózati nyomkövetési eszközt a kód, a hibatípus és a további paraméterek olvasásához. A teljes listát a Partnerközpont REST-hibakódjai című témakörben találja.

Példa válaszra

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