İlke ile cihaz listesini güncelleştirme

  • Makale
  • Okumak için 2 dakika

Uygulama:İş Ortağı Merkezi | İş Ortağı Merkezi Microsoft Bulut Almanya için destek

Belirtilen müşteri için bir yapılandırma ilkesiyle cihazların listesini güncelleştirme.

Önkoşullar

  • kimlik doğrulamasında açıklandığı gibi İş Ortağı Merkezi bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamasını destekler.

  • Müşteri kimliği ( customer-tenant-id ). Müşterinin kimliğini bilmiyorsanız bu kimliği panoda İş Ortağı Merkezi. İş Ortağı Merkezi'den CSP'yi ve ardından Müşteriler'i seçin. Müşteri listesinden müşteriyi ve ardından Hesap'ı seçin. Müşterinin Hesap sayfasında Müşteri Hesabı Bilgileri bölümünde MicrosoftKimliği'ne bakın. Microsoft Kimliği, müşteri kimliği () ile customer-tenant-id aynıdır.

  • İlke tanımlayıcısı.

  • Güncelleştirilen cihazların cihaz tanımlayıcıları.

C#

Cihazların listesini belirtilen yapılandırma ilkesiyle güncelleştirmek için, önce [KeyValuePair/dotnet/api/system.collections.generic.list-1) türünde bir [List/dotnet/dotnet/api/system.collections.generic.keyvaluepair-2)örneği yapın ve uygulanacak ilkeyi aşağıdaki kod örneğinde gösterildiği gibi ekleyin. İlkenin ilke tanımlayıcısı gerekir.

Ardından, her cihaz için cihaz tanımlayıcısını ve uygulanacak ilkeyi içeren listeyi belirterek ilkeyle güncelleştirilen Cihaz nesnelerinin listesini oluşturun. Ardından bir DevicePolicyUpdateRequest nesnesi başlatın ve Devices özelliğini cihaz nesneleri listesine ayarlayın.

Cihaz ilkesi güncelleştirme isteğini işleme almak için IAggregatePartner.Customers.ById yöntemini müşteri tanımlayıcısıyla çağırarak belirtilen müşteri üzerinde işlemlere bir arabirim alın. Ardından, müşteri cihaz toplama işlemlerine bir arabirim almak için DevicePolicy özelliğini alın. Son olarak, cihazları ilkeyle güncelleştirmek için DevicePolicyUpdateRequest nesnesiyle Update yöntemini çağırabilirsiniz.

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

Örnek:Konsol test uygulaması. Project:İş Ortağı Merkezi SDK'sı Örnekleri Sınıfı:UpdateDevicesPolicy.cs

REST isteği

İstek söz dizimi

Yöntem İstek URI'si
YAMA {baseURL}/v1/customers/{customer-id}/DevicePolicyUpdates HTTP/1.1

URI parametresi

İsteği oluştururken aşağıdaki yol parametrelerini kullanın.

Ad Tür Gerekli Açıklama
customer-id string Yes Müşteriyi tanımlayan GUID biçimli bir dize.

İstek üst bilgileri

Daha fazla bilgi için bkz. İş Ortağı Merkezi REST üst bilgileri.

İstek gövdesi

İstek gövdesi bir DevicePolicyUpdateRequest kaynağı içermeli.

İstek örneği

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

REST yanıtı

Başarılı olursa yanıt, bu toplu işlem durumunu almak için uri'ye sahip bir Konum üst bilgisi içerir. Diğer ilgili REST API'leriyle kullanmak için bu URI'yi kaydedin.

Yanıt başarı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu gösteren bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. İŞ ORTAĞı MERKEZI REST hata kodları.

Yanıt örneği

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