Aktualisieren einer Konfigurationsrichtlinie für den angegebenen Kunden

Artikel
09/11/2024

Gilt für: Partner Center

So aktualisieren Sie die angegebene Konfigurationsrichtlinie für den angegebenen Kunden.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
Eine Kunden-ID (customer-tenant-id). Wenn Sie die Kunden-ID 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 Seite Konto des Kunden im Abschnitt Kundenkontoinformationen nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).
Der Richtlinienbezeichner.

C#

Um eine vorhandene Konfigurationsrichtlinie für den angegebenen Kunden zu aktualisieren, instanziieren Sie ein neues ConfigurationPolicy-Objekt , wie im folgenden Codeausschnitt gezeigt. Die Werte in diesem neuen Objekt ersetzen die entsprechenden Werte im vorhandenen Objekt. 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. Rufen Sie als Nächstes die ConfigurationPolicies.ById-Methode mit der Richtlinien-ID auf, um eine Schnittstelle zu Konfigurationsrichtlinienvorgängen für die angegebene Richtlinie abzurufen. Rufen Sie abschließend die Patch- oder PatchAsync-Methode auf, um die Konfigurationsrichtlinie zu aktualisieren.

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

Beispiel: Konsolentest-App. Projekt: Partner Center SDK-Beispielklasse: UpdateConfigurationPolicy.cs

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
PUT	{baseURL}/v1/customers/{customer-id}/policies/{policy-id} 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.
policy-id	Zeichenfolge	Ja	Eine GUID-formatierte Zeichenfolge, die die zu aktualisierende Richtlinie identifiziert.

Anforderungsheader

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

Anforderungstext

Der Anforderungstext muss ein Objekt enthalten, das die Richtlinieninformationen bereitstellt.

Name	Typ	Erforderlich	Aktualisierbar	BESCHREIBUNG
id	Zeichenfolge	Ja	Nein	Die GUID-formatierte Zeichenfolge, die die Richtlinie identifiziert.
name	Zeichenfolge	Ja	Ja	Der Anzeigename der Richtlinie.
category	Zeichenfolge	Ja	Nein	Die Richtlinienkategorie.
description	Zeichenfolge	Nein	Ja	Die Richtlinienbeschreibung.
devicesAssigned	number	Nein	Nein	Die Anzahl der Geräte.
policySettings	array of strings	Ja	Ja	Die Richtlinieneinstellungen: "none","remove_oem_preinstalls","oobe_user_not_local_admin","skip_express_settings","skip _oem_registration,"skip_eula".

Anforderungsbeispiel

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

Freigeben über