Belirtilen müşteri için yeni bir yapılandırma ilkesini güncelleştirme

  • Makale
  • Okumak için 2 dakika

Uygulama hedefi: Iş Ortağı Merkezi | Microsoft Bulut Almanya için iş ortağı Merkezi

Belirtilen müşteri için belirtilen yapılandırma ilkesini güncelleştirme.

Önkoşullar

  • Iş ortağı merkezi kimlik doğrulamasındaaçıklandığı gibi kimlik bilgileri. Bu senaryo, hem tek başına uygulama hem de uygulama + kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

  • Bir müşteri KIMLIĞI ( customer-tenant-id ). Müşterinin KIMLIĞINI bilmiyorsanız Iş Ortağı Merkezi panosundabulabilirsiniz. Iş Ortağı Merkezi menüsünden CSP ' yi ve ardından müşteriler' i seçin. Müşteri listesinden müşteriyi seçin ve ardından Hesap' ı seçin. Müşterinin hesap sayfasında, müşteri hesabı bilgileri bölümünde Microsoft kimliği ' ni arayın. Microsoft KIMLIĞI, müşteri KIMLIĞI () ile aynıdır customer-tenant-id .

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

C#

Belirtilen müşteri için varolan bir yapılandırma ilkesini güncelleştirmek üzere, aşağıdaki kod parçacığında gösterildiği gibi yeni bir Configurationpolicy nesnesi örneği oluşturun. Bu yeni nesnedeki değerler varolan nesnede karşılık gelen değerleri değiştirir. Ardından, belirtilen müşterideki işlemlere bir arabirim almak için, müşteri KIMLIĞIYLE ıaggregatepartner. Customers. Byıd yöntemini çağırın. Ardından, belirtilen ilke için yapılandırma ilkesi işlemlerine bir arabirim almak üzere ilke KIMLIĞIYLE Configurationpolicies. Byıd yöntemini çağırın. Son olarak, yapılandırma ilkesini güncelleştirmek için Patch veya patchasync metodunu çağırın.

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

Örnek: konsol test uygulaması. Project: iş ortağı merkezi SDK örnekleri sınıfı: updateconfigurationpolicy. cs

REST isteği

İstek sözdizimi

Yöntem İstek URI'si
PUT {BaseUrl}/v1/Customers/{Customer-id}/policies/{Policy-ID} http/1.1

URI parametresi

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

Ad Tür Gerekli Açıklama
müşteri kimliği string Yes Müşteriyi tanımlayan GUID biçimli bir dize.
ilke kimliği string Yes Güncelleştirilecek ilkeyi tanımlayan GUID biçimli bir dize.

İstek üst bilgileri

Daha fazla bilgi için bkz. Iş ortağı MERKEZI Rest üstbilgileri.

İstek gövdesi

İstek gövdesi, ilke bilgilerini sağlayan bir nesne içermelidir.

Ad Tür Gerekli Güncelleştirilebilir Description
kimlik string Yes Hayır İlkeyi tanımlayan GUID biçimli dize.
name string Yes Yes İlkenin kolay adı.
category string Yes Hayır İlke kategorisi.
açıklama dize No Yes İlke açıklaması.
devicesAssigned sayı Hayır Hayır Cihaz sayısı.
policySettings dize dizisi Yes Yes İlke ayarları: "none", "remove_oem_preinstalls", "oobe_user_not_local_admin", "skip_express_settings", "Skip _oem_registration," skip_eula ".

İstek örneği

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: de894e18-f027-4ac0-8b5a-34f0c222af0c
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"]
}

REST yanıtı

Başarılı olursa, yanıt gövdesi yeni ilke için Configurationpolicy kaynağını içerir.

Yanıt başarısı ve hata kodları

Her yanıt başarı veya başarısızlık ve ek hata ayıklama bilgilerini gösteren bir HTTP durum kodu ile gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. Iş ortağı MERKEZI Rest hata kodları.

Yanıt örneği

HTTP/1.1 200 OK
Content-Length: 421
Content-Type: application/json; charset=utf-8
MS-CorrelationId: f9fd5973-6ad8-4585-aadc-f2b0443fe27b
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"
    }
}