Teilen über

Erstellen einer neuen Konfigurationsrichtlinie für den angegebenen Kunden

  • Artikel

Gilt für: Partner Center

Erstellen einer neuen Konfigurationsrichtlinie für den angegebenen Kunden

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung sowohl mit eigenständigen App- als auch mit App+Benutzeranmeldeinformationen.

  • Eine Kunden-ID (customer-tenant-id). Wenn Sie die ID des Kunden nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich Kunden und dann den Kunden aus der Kundenliste und dann Konto auswählen. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).

C#

So erstellen Sie eine neue Konfigurationsrichtlinie für den angegebenen Kunden:

  1. Instanziieren Sie ein neues ConfigurationPolicy-Objekt , wie im folgenden Codeausschnitt gezeigt. Rufen Sie dann die IAggregatePartner.Customers.ById-Methode mit der Kunden-ID auf, um eine Schnittstelle zu Vorgängen für den angegebenen Kunden abzurufen.

  2. Rufen Sie die ConfigurationPolicies-Eigenschaft ab, um eine Schnittstelle zu Sammlungsvorgängen für Konfigurationsrichtlinien abzurufen.

  3. Rufen Sie die Create - oder CreateAsync-Methode auf, um die Konfigurationsrichtlinie zu erstellen.

C#-Beispiel

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

Beispiel: Konsolentest-App. Project: Partner Center SDK Samples Class: CreateConfigurationPolicy.cs

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
POST {baseURL}/v1/customers/{customer-id}/policies HTTP/1.1

URI-Parameter

Verwenden Sie beim Erstellen der Anforderung die folgenden Pfadparameter.

Name Typ Erforderlich BESCHREIBUNG
Kunden-ID Zeichenfolge Ja Eine GUID-formatierte Zeichenfolge, die den Kunden identifiziert.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Der Anforderungstext muss ein -Objekt mit den Konfigurationsrichtlinieninformationen enthalten, wie in der folgenden Tabelle beschrieben:

Name Typ Erforderlich BESCHREIBUNG
name Zeichenfolge Ja Der Anzeigename der Richtlinie.
category Zeichenfolge Ja Die Richtlinienkategorie.
description Zeichenfolge Nein Die Richtlinienbeschreibung.
policySettings array of strings Ja Die Richtlinieneinstellungen.

Anforderungsbeispiel

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-Antwort

Bei erfolgreicher Ausführung enthält der Antworttext die ConfigurationPolicy-Ressource für die neue Richtlinie.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Antwortbeispiel

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