Uppdatera en lista över enheter med en princip

Artikel
09/11/2024

Gäller för: Partnercenter

Så här uppdaterar du en lista över enheter med en 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 från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).
Principidentifieraren.
Enhetsidentifierarna för de enheter som ska uppdateras.

C#

Om du vill uppdatera en lista över enheter med den angivna konfigurationsprincipen instansierar du först en [List/dotnet/api/system.collections.generic.list-1) av typen [KeyValuePair/dotnet/api/system.collections.generic.keyvaluepair-2)(PolicyCategory,string) och lägger till principen som ska tillämpas, enligt följande kodexempel. Du behöver principidentifieraren för principen.

Skapa sedan en lista över enhetsobjekt som ska uppdateras med principen och ange enhetsidentifieraren och listan som innehåller principen som ska tillämpas för varje enhet. Instansiera sedan ett DevicePolicyUpdateRequest-objekt och ange egenskapen Enheter till listan över enhetsobjekt.

Om du vill bearbeta begäran om enhetsprincipuppdatering anropar du metoden IAggregatePartner.Customers.ById med kundidentifieraren för att hämta ett gränssnitt till åtgärder på den angivna kunden. Hämta sedan egenskapen DevicePolicy för att hämta ett gränssnitt för insamlingsåtgärder för kundenheter. Anropa slutligen metoden Update med objektet DevicePolicyUpdateRequest för att uppdatera enheterna med principen.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedConfigurationPolicyId;
string selectedDeviceId;

// Indicate the policy to apply to the list of devices.
List<KeyValuePair<PolicyCategory, string>>
    policyToBeAdded = new List<KeyValuePair<PolicyCategory, string>>
{
    new KeyValuePair<PolicyCategory, string>
        (PolicyCategory.OOBE, selectedConfigurationPolicyId)
};

// Create a list of devices to be updated with a policy.
List<Device> devices = new List<Device>
{
    new Device
    {
        Id = selectedDeviceId,
        Policies=policyToBeAdded
    }
};

// Instantiate a DevicePolicyUpdateRequest object.
DevicePolicyUpdateRequest
    devicePolicyUpdateRequest = new DevicePolicyUpdateRequest
{
    Devices = devices
};

// Process the DevicePolicyUpdateRequest.
var trackingLocation =
    partnerOperations.Customers.ById(selectedCustomerId).DevicePolicy.Update(devicePolicyUpdateRequest);

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

REST-begäran

Syntax för begäran

Metod	URI för förfrågan
PATCH	{baseURL}/v1/customers/{customer-id}/DevicePolicy Uppdateringar HTTP/1.1

URI-parameter

Använd följande sökvägsparametrar när du skapar begäran.

Namn	Typ	Obligatoriskt	Beskrivning
kund-ID	sträng	Ja	En GUID-formaterad sträng som identifierar kunden.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Begärandetexten måste innehålla en DevicePolicyUpdateRequest-resurs .

Exempel på begäran

PATCH https://api.partnercenter.microsoft.com/v1/customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/DevicePolicyUpdates HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 1b658428-5afa-46d4-af86-c9c6af5634e2
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 363
Expect: 100-continue
Connection: Keep-Alive

{
    "Devices": [{
            "Id": "9993-8627-3608-6844-6369-4361-72",
            "SerialNumber": null,
            "ProductKey": null,
            "HardwareHash": null,
            "Policies": [{
                    "Key": "o_o_b_e",
                    "Value": "15a04610-9229-4e80-94e0-0e826a09c9e2"
                }
            ],
            "CreatedBy": null,
            "UploadedDate": "0001-01-01T00:00:00",
            "AllowedOperations": null,
            "Attributes": {
                "ObjectType": "Device"
            }
        }
    ],
    "Attributes": {
        "ObjectType": "DevicePolicyUpdateRequest"
    }
}

Viktigt!

Från och med juni 2023 arkiveras nu den senaste Partner Center .NET SDK-versionen 3.4.0. Du kan ladda ned SDK-versionen från GitHub tillsammans med en readme-fil som innehåller användbar information.

Partner uppmanas att fortsätta att använda REST-API:er för Partnercenter.

REST-svar

Om det lyckas innehåller svaret ett platshuvud som har en URI som kan användas för att hämta status för den här batchprocessen. Spara den här URI:n för användning med andra relaterade REST-API:er.

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 Rest-felkoder för Partnercenter.

Svarsexempel

HTTP/1.1 202 Accepted
Content-Length: 0
Location: /customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/batchJobStatus/a15f3996-620a-4404-9f1f-4c2de78de0de
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 1b658428-5afa-46d4-af86-c9c6af5634e2
MS-CV: rCXyd8Z/lUSxUd0P.0
MS-ServerId: 020021921
Date: Thu, 28 Sep 2017 21:33:05 GMT

Dela via