Aktualizowanie zasad konfiguracji dla określonego klienta

Artykuł
09/11/2024

Dotyczy: Centrum partnerskie

Jak zaktualizować określone zasady konfiguracji dla określonego klienta.

Wymagania wstępne

Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.
Identyfikator klienta (customer-tenant-id). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w Centrum partnerskim , wybierając obszar roboczy Klienci , a następnie klienta z listy klienta, a następnie pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta . Identyfikator Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).
Identyfikator zasad.

C#

Aby zaktualizować istniejące zasady konfiguracji dla określonego klienta, utwórz wystąpienie nowego obiektu ConfigurationPolicy , jak pokazano w poniższym fragmencie kodu. Wartości w tym nowym obiekcie zastępują odpowiednie wartości w istniejącym obiekcie. Następnie wywołaj metodę IAggregatePartner.Customers.ById z identyfikatorem klienta, aby pobrać interfejs operacji na określonym kliencie. Następnie wywołaj metodę ConfigurationPolicies.ById z identyfikatorem zasad, aby pobrać interfejs operacji zasad konfiguracji dla określonych zasad. Na koniec wywołaj metodę Patch lub PatchAsync , aby zaktualizować zasady konfiguracji.

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

Przykład: aplikacja testowa konsoli. Projekt: Klasa przykładów zestawu SDK Centrum partnerskiego: UpdateConfigurationPolicy.cs

Żądanie REST

Składnia żądania

Metoda	Identyfikator URI żądania
PUT	{baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1

Parametr identyfikatora URI

Podczas tworzenia żądania użyj następujących parametrów ścieżki.

Nazwa	Typ	Wymagane	Opis
customer-id	ciąg	Tak	Ciąg sformatowany przez identyfikator GUID, który identyfikuje klienta.
identyfikator zasad	ciąg	Tak	Ciąg sformatowany przez identyfikator GUID, który identyfikuje zasady do zaktualizowania.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Treść żądania musi zawierać obiekt, który dostarcza informacje o zasadach.

Nazwa	Typ	Wymagane	Aktualizowalna	Opis
identyfikator	ciąg	Tak	Nie	Ciąg sformatowany przez identyfikator GUID, który identyfikuje zasady.
name	ciąg	Tak	Tak	Przyjazna nazwa zasad.
category	ciąg	Tak	Nie	Kategoria zasad.
description (opis)	ciąg	Nie	Tak	Opis zasad.
devicesAssigned	liczba	Nie	Nie	Liczba urządzeń.
policySettings	tablica ciągów	Tak	Tak	Ustawienia zasad: "none","remove_oem_preinstalls","oobe_user_not_local_admin","skip_express_settings","skip _oem_registration,"skip_eula".

Przykład żądania

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

Odpowiedź REST

W przypadku powodzenia treść odpowiedzi zawiera zasób ConfigurationPolicy dla nowych zasad.

Kody powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie oraz dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.

Przykład odpowiedzi

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

Udostępnij za pośrednictwem