Új konfigurációs szabályzat létrehozása a megadott ügyfélnél

A következőre vonatkozik: Partnerközpont

Új konfigurációs szabályzat létrehozása a megadott ügyfélhez.

Előfeltételek

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

• Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület, majd az ügyféllista ügyféllistájá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).

C#

Új konfigurációs szabályzat létrehozása a megadott ügyfélhez:

1. Hozzon létre egy új ConfigurationPolicy objektumot az alábbi kódrészletben látható módon. Ezután hívja meg az IAggregatePartner.Customers.ById metódust az ügyfélazonosítóval, hogy lekérjen egy felületet a megadott ügyfél műveleteihez.

2. A ConfigurationPolicies tulajdonság lekérésével lekérheti a konfigurációs házirend-gyűjtési műveletek felületét.

3. Hívja meg a Create vagy a CreateAsync metódust a konfigurációs szabályzat létrehozásához.

C# példa

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

var configurationPolicyToCreate = new ConfigurationPolicy
{
    Name = "Test Config Policy",
    Description = "This configuration policy is created by the SDK samples",
    PolicySettings = new List<PolicySettingsType>() {
        PolicySettingsType.OobeUserNotLocalAdmin,
        PolicySettingsType.SkipEula }
};

var createdConfigurationPolicy =
    partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.Create(configurationPolicyToCreate);

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

REST-kérelem

Kérés szintaxisa

Metódus	Kérés URI-ja
POST	{baseURL}/v1/customers/{customer-id}/policies 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.

Kérésfejlécek

További információt a Partnerközpont REST-fejlécei című témakörben talál.

A kérés törzse

A kérelemtörzsnek tartalmaznia kell egy objektumot, amely tartalmazza a konfigurációs szabályzat adatait az alábbi táblázatban leírtak szerint:

Név	Típus	Kötelező	Leírás
name	sztring	Igen	A szabályzat rövid neve.
category	sztring	Igen	A szabályzatkategória.
leírás	sztring	No	A szabályzat leírása.
policySettings	sztringek tömbje	Yes	A szabályzat beállításai.

Példa kérésre

POST https://api.partnercenter.microsoft.com//v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/policies 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: 212
Content-Type: application/json
Host: api.partnercenter.microsoft.com

{
    "name": "Windows 10 Enterprise E5",
    "category": "o_o_b_e",
    "description": "test policy creation from API",
    "policySettings": ["oobe_user_not_local_admin", "skip_express_settings"]
}

REST-válasz

Ha sikeres, 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: 404
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 4beda413-74fc-4839-b74f-f580c353ab45
MS-RequestId: 0dfadf74-aa66-49ed-9a67-b3b78d9297cc
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:07:36 GMT

{
    "id": "40cdb858-edcc-44d7-9083-d6a36d43bd3f",
    "name": "Windows 10 Enterprise E5",
    "category": "o_o_b_e",
    "description": "test policy creation from API",
    "devicesAssigned": 0,
    "policySettings": ["oobe_user_not_local_admin", "skip_express_settings"],
    "createdDate": "2017-07-25T18:07:36",
    "lastModifiedDate": "2017-07-25T18:07:36",
    "attributes": {
        "objectType": "ConfigurationPolicy"
    }
}