Aggiornare un criterio di configurazione per il cliente specificato

Articolo
09/11/2024

Si applica a: Centro per i partner

Come aggiornare i criteri di configurazione specificati per il cliente specificato.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente cercare l'ID Microsoft nella sezione Informazioni sull'account del cliente . L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).
Identificatore dei criteri.

C#

Per aggiornare un criterio di configurazione esistente per il cliente specificato, creare un'istanza di un nuovo oggetto ConfigurationPolicy , come illustrato nel frammento di codice seguente. I valori di questo nuovo oggetto sostituiscono i valori corrispondenti nell'oggetto esistente. Chiamare quindi il metodo IAggregatePartner.Customers.ById con l'ID cliente per recuperare un'interfaccia alle operazioni sul cliente specificato. Chiamare quindi il metodo ConfigurationPolicies.ById con l'ID criterio per recuperare un'interfaccia per le operazioni dei criteri di configurazione per i criteri specificati. Infine, chiamare il metodo Patch o PatchAsync per aggiornare i criteri di configurazione.

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

Esempio: App di test della console. Progetto: Classe di esempi dell'SDK del Centro per i partner: UpdateConfigurationPolicy.cs

Richiesta REST

Sintassi della richiesta

Metodo	URI richiesta
PUT	{baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1

Parametro URI

Usare i parametri di percorso seguenti durante la creazione della richiesta.

Nome	Tipo	Obbligatoria	Descrizione
customer-id	string	Sì	Stringa in formato GUID che identifica il cliente.
policy-id	string	Sì	Stringa in formato GUID che identifica i criteri da aggiornare.

Intestazioni della richiesta

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Il corpo della richiesta deve contenere un oggetto che fornisce le informazioni sui criteri.

Nome	Tipo	Necessario	Aggiornabile	Descrizione
id	string	Sì	No	Stringa in formato GUID che identifica i criteri.
name	string	Sì	Sì	Nome descrittivo del criterio.
category	string	Sì	No	Categoria di criteri.
description	string	No	Sì	Descrizione dei criteri.
devicesAssigned	d'acquisto	No	No	Numero di dispositivi.
policySettings	matrice di stringhe	Sì	Sì	Le impostazioni dei criteri: "none","remove_oem_preinstalls","oobe_user_not_local_admin","skip_express_settings","skip _oem_registration,"skip_eula".

Esempio di richiesta

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: aaaa0000-bb11-2222-33cc-444444dddddd
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"]
}

Risposta REST

In caso di esito positivo, il corpo della risposta contiene la risorsa ConfigurationPolicy per il nuovo criterio.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Esempio di risposta

HTTP/1.1 200 OK
Content-Length: 421
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
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"
    }
}

Condividi tramite