Skapa en ny konfigurationsprincip för den angivna kunden

Artikel
09/11/2024

Gäller för: Partnercenter

Så här skapar du en ny konfigurationsprincip 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+User-autentiseringsuppgifter.
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 i 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).

C#

Så här skapar du en ny konfigurationsprincip för den angivna kunden:

Instansiera ett nytt ConfigurationPolicy-objekt enligt följande kodfragment. Anropa sedan metoden IAggregatePartner.Customers.ById med kund-ID:t för att hämta ett gränssnitt till åtgärder för den angivna kunden.
Hämta egenskapen ConfigurationPolicies för att hämta ett gränssnitt till åtgärder för insamling av konfigurationsprinciper.
Anropa metoden Create eller CreateAsync för att skapa konfigurationsprincipen.

C#-exempel

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

Exempel: Konsoltestapp. Projekt: SDK-exempelklass för Partnercenter: CreateConfigurationPolicy.cs

REST-begäran

Begärandesyntax

Metod	URI för förfrågan
INLÄGG	{baseURL}/v1/customers/{customer-id}/policies 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.

Begärandehuvuden

Mer information finns i REST-huvuden i Partnercenter.

Begärandetext

Begärandetexten måste innehålla ett objekt med konfigurationsprincipinformationen enligt beskrivningen i följande tabell:

Namn	Typ	Obligatorisk	Beskrivning
name	sträng	Ja	Principens eget namn.
category	sträng	Ja	Principkategorin.
beskrivning	sträng	No	Principbeskrivningen.
policySettings	matris med strängar	Yes	Principinställningarna.

Exempel på begäran

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: aaaa0000-bb11-2222-33cc-444444dddddd
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-svar

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

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad 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: 404
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
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"
    }
}

Dela via