Aktualizace seznamu zařízení s využitím zásad

  • Článek

Platí pro: Partnerské centrum

Postup aktualizace seznamu zařízení pomocí zásad konfigurace pro zadaného zákazníka

Požadavky

  • Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.

  • ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

  • Identifikátor zásady.

  • Identifikátory zařízení, která se mají aktualizovat.

C#

Pokud chcete aktualizovat seznam zařízení pomocí zadaných zásad konfigurace, nejprve vytvořte instanci [List/dotnet/api/system.collections.generic.list-1) typu [KeyValuePair/dotnet/api/system.collections.generic.keyvaluepair-2)(PolicyCategory;string) a přidejte zásadu, která se má použít, jak je znázorněno v následujícím příkladu kódu. Budete potřebovat identifikátor zásady.

Potom vytvořte seznam objektů zařízení , které se mají aktualizovat pomocí zásad, a zadejte identifikátor zařízení a seznam obsahující zásady, které se mají použít, pro každé zařízení. Dále vytvořte instanci DevicePolicyUpdateRequest objektu a nastavte Device vlastnost na seznam objektů zařízení.

Pokud chcete zpracovat požadavek na aktualizaci zásad zařízení, zavolejte metodu IAggregatePartner.Customers.ById s identifikátorem zákazníka, která načte rozhraní pro operace se zadaným zákazníkem. Potom načtěte vlastnost DevicePolicy , abyste získali rozhraní pro operace shromažďování zařízení zákazníka. Nakonec zavolejte metodu Update s objektem DevicePolicyUpdateRequest pro aktualizaci zařízení pomocí zásad.

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

Ukázka: Konzolová testovací aplikace Projekt: Třída ukázek sady SDK Partnerského centra: UpdateDevicesPolicy.cs

Požadavek REST

Syntaxe požadavku

metoda Identifikátor URI žádosti
PATCH {baseURL}/v1/customers/{customer-id}/DevicePolicy Aktualizace HTTP/1.1

Parametr identifikátoru URI

Při vytváření požadavku použijte následující parametry cesty.

Name Type Požadováno Popis
ID zákazníka string Ano Řetězec formátovaný identifikátorem GUID, který identifikuje zákazníka.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Tělo požadavku musí obsahovat prostředek DevicePolicyUpdateRequest .

Příklad požadavku

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: 49b1e7b2-82e7-4403-b63b-8765269b448d
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"
    }
}

Důležité

Od června 2023 se teď archivuje nejnovější verze sady .NET SDK partnerského centra 3.4.0. Vydání sady SDK si můžete stáhnout z GitHubu spolu se souborem readme, který obsahuje užitečné informace.

Doporučujeme, aby partneři dál používali rozhraní REST API Partnerského centra.

Odpověď REST

V případě úspěchu odpověď obsahuje hlavičku Umístění , která má identifikátor URI, který lze použít k načtení stavu tohoto dávkového procesu. Uložte tento identifikátor URI pro použití s jinými souvisejícími rozhraními REST API.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.

Příklad odpovědi

HTTP/1.1 202 Accepted
Content-Length: 0
Location: /customers/c7f3c849-129f-4b85-a96d-4f8e88b315a3/batchJobStatus/a15f3996-620a-4404-9f1f-4c2de78de0de
MS-CorrelationId: 49b1e7b2-82e7-4403-b63b-8765269b448d
MS-RequestId: 1b658428-5afa-46d4-af86-c9c6af5634e2
MS-CV: rCXyd8Z/lUSxUd0P.0
MS-ServerId: 020021921
Date: Thu, 28 Sep 2017 21:33:05 GMT