透過原則更新裝置清單

發行項
09/11/2024

適用於：合作夥伴中心

如何使用指定客戶的設定原則來更新裝置清單。

必要條件

認證，如合作夥伴中心驗證所述。此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
客戶識別碼 (customer-tenant-id)。如果您不知道客戶的標識碼，您可以在合作夥伴中心中選取 [客戶] 工作區，然後從客戶清單中查看客戶，然後從 [帳戶]。在客戶的 [帳戶] 頁面上，在 [客戶帳戶資訊] 區段中尋找 Microsoft 標識符。 Microsoft 識別碼與客戶識別碼 (customer-tenant-id) 相同。
原則標識碼。
要更新之裝置的裝置標識碼。

C#

若要使用指定的設定原則來更新裝置清單，請先具現化 [KeyValuePair/dotnet/api/dotnet/api/system.collections.generic.list-1] 類型的 [List/dotnet/api/system.collections.generic.keyvaluepair-2），並新增要套用的原則，如下列程式代碼範例所示。您需要原則的原則標識碼。

然後，針對每個裝置，建立要更新原則的 Device 物件清單，並指定要套用之原則的裝置識別碼和清單。接下來，將DevicePolicyUpdateRequest物件具現化，並將Devices屬性設定為裝置物件清單。

若要處理裝置原則更新要求，請使用客戶標識符呼叫 IAggregatePartner.Customers.ById 方法，以擷取指定客戶的作業介面。然後，擷 取 DevicePolicy 屬性，以取得客戶裝置集合作業的介面。最後，使用 DevicePolicyUpdateRequest 物件呼叫 Update 方法，以使用原則更新裝置。

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

範例：控制台測試應用程式。專案：合作夥伴中心 SDK 範例類別:UpdateDevicesPolicy.cs

REST 要求

要求語法

方法	要求 URI
PATCH	{baseURL}/v1/customers/{customer-id}/DevicePolicy 更新 HTTP/1.1

URI 參數

建立要求時，請使用下列路徑參數。

名稱	類型	必要	描述
customer-id	string	Yes	識別客戶的 GUID 格式字串。

要求標頭

如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

要求本文

要求本文必須包含 DevicePolicyUpdateRequest 資源。

要求範例

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

重要

自 2023 年 6 月起，最新的合作夥伴中心 .NET SDK 3.4.0 版現已封存。您可以從 GitHub 下載 SDK 版本，以及包含實用資訊的自述檔。

鼓勵合作夥伴繼續使用合作夥伴中心 REST API。

REST 回應

如果成功，回應會包含位置標頭，該標頭具有可用來擷取此批處理狀態的 URI。儲存此 URI 以與其他相關的 REST API 搭配使用。

回應成功和錯誤碼

每個回應都隨附 HTTP 狀態碼，會指出成功與否以及其他的偵錯資訊。請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。如需完整清單，請參閱合作夥伴中心的 REST 錯誤碼。

回應範例

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

共用方式為