Een lijst met apparaten met een beleid bijwerken

Artikel
09/11/2024

Van toepassing op: Partnercentrum

Een lijst met apparaten bijwerken met een configuratiebeleid voor de opgegeven klant.

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.
Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).
De beleids-id.
De apparaat-id's van de apparaten die moeten worden bijgewerkt.

C#

Als u een lijst met apparaten wilt bijwerken met het opgegeven configuratiebeleid, instantieert u eerst een [List/dotnet/api/system.collections.generic.list-1) van het type [KeyValuePair/dotnet/api/system.collections.generic.keyvaluepair-2)(PolicyCategory,string) en voegt u het toe te passen beleid, zoals wordt weergegeven in het volgende codevoorbeeld. U hebt de beleids-id van het beleid nodig.

Maak vervolgens een lijst met apparaatobjecten die moeten worden bijgewerkt met het beleid, waarbij u de apparaat-id en de lijst opgeeft die het beleid bevat dat moet worden toegepast, voor elk apparaat. Maak vervolgens een DevicePolicyUpdateRequest-object en stel de eigenschap Apparaten in op de lijst met apparaatobjecten.

Als u de aanvraag voor het bijwerken van apparaatbeleid wilt verwerken, roept u de methode IAggregatePartner.Customers.ById aan met de klant-id om een interface op te halen voor bewerkingen op de opgegeven klant. Haal vervolgens de eigenschap DevicePolicy op om een interface op te halen voor apparaatverzamelingsbewerkingen van klanten. Roep tot slot de updatemethode aan met het object DevicePolicyUpdateRequest om de apparaten bij te werken met het beleid.

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

Voorbeeld: consoletest-app. Project: Voorbeeldklasse partnercentrum-SDK: UpdateDevicesPolicy.cs

REST-aanvraag

Aanvraagsyntaxis

Wijze	Aanvraag-URI
PATCH	{baseURL}/v1/customers/{customer-id}/DevicePolicyUpdates HTTP/1.1

URI-parameter

Gebruik de volgende padparameters bij het maken van de aanvraag.

Name	Type	Vereist	Beschrijving
klant-id	tekenreeks	Ja	Een tekenreeks met GUID-indeling die de klant identificeert.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

De aanvraagbody moet een DevicePolicyUpdateRequest-resource bevatten.

Aanvraagvoorbeeld

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

Belangrijk

Vanaf juni 2023 wordt de nieuwste Versie van Partner Center .NET SDK 3.4.0 gearchiveerd. U kunt de SDK-release downloaden van GitHub, samen met een leesmij-bestand dat nuttige informatie bevat.

Partners worden aangemoedigd om de REST API's van partnercentrum te blijven gebruiken.

REST-antwoord

Als dit lukt, bevat het antwoord een locatieheader met een URI die kan worden gebruikt om de status van dit batchproces op te halen. Sla deze URI op voor gebruik met andere gerelateerde REST API's.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.

Responsvoorbeeld

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

Delen via