Criar uma nova política de configuração para o cliente especificado

Artigo
09/11/2024

Aplica-se a: Centro de Parceiros

Como criar uma nova política de configuração para o cliente especificado.

Pré-requisitos

Credenciais conforme descrito na autenticação do Centro de Parceiros. Este cenário suporta a autenticação com credenciais autónomas da Aplicação e da Aplicação+Utilizador.
Um ID de cliente (customer-tenant-id). Se não souber o ID do cliente, pode procurá-lo no Centro de Parceiros selecionando a área de trabalho Clientes e, em seguida, o cliente na lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure o ID Microsoft na secção Informações da Conta de Cliente . O ID da Microsoft é o mesmo que o ID do cliente (customer-tenant-id).

C#

Para criar uma nova política de configuração para o cliente especificado:

Instanciar um novo objeto ConfigurationPolicy , conforme mostrado no fragmento de código seguinte. Em seguida, chame o método IAggregatePartner.Customers.ById com o ID do cliente para obter uma interface para operações no cliente especificado.
Obtenha a propriedade ConfigurationPolicies para obter uma interface para as operações de recolha de políticas de configuração.
Chame o método Create or CreateAsync para criar a política de configuração.

Exemplo de C#

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

var configurationPolicyToCreate = new ConfigurationPolicy
{
    Name = "Test Config Policy",
    Description = "This configuration policy is created by the SDK samples",
    PolicySettings = new List<PolicySettingsType>() {
        PolicySettingsType.OobeUserNotLocalAdmin,
        PolicySettingsType.SkipEula }
};

var createdConfigurationPolicy =
    partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.Create(configurationPolicyToCreate);

Exemplo: aplicação de teste da consola. Project: Classe de Exemplos do SDK do Centro de Parceiros: CreateConfigurationPolicy.cs

Pedido REST

Sintaxe do pedido

Método	URI do pedido
POST	{baseURL}/v1/customers/{customer-id}/policies HTTP/1.1

Parâmetro URI

Utilize os seguintes parâmetros de caminho ao criar o pedido.

Nome	Tipo	Necessário	Descrição
customer-id	string	Yes	Uma cadeia formatada por GUID que identifica o cliente.

Cabeçalhos do pedido

Para obter mais informações, veja Cabeçalhos REST do Centro de Parceiros.

Corpo do pedido

O corpo do pedido tem de conter um objeto com as informações da política de configuração, conforme descrito na tabela seguinte:

Nome	Tipo	Necessário	Descrição
name	string	Yes	O nome amigável da política.
categoria	string	Yes	A categoria de política.
descrição	cadeia (de carateres)	No	A descrição da política.
policySettings	matriz de cadeias (de carateres)	Sim	As definições de política.

Exemplo de pedido

POST https://api.partnercenter.microsoft.com//v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/policies 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: 212
Content-Type: application/json
Host: api.partnercenter.microsoft.com

{
    "name": "Windows 10 Enterprise E5",
    "category": "o_o_b_e",
    "description": "test policy creation from API",
    "policySettings": ["oobe_user_not_local_admin", "skip_express_settings"]
}

Resposta do REST

Se for bem-sucedido, o corpo da resposta contém o recurso ConfigurationPolicy para a nova política.

Códigos de erro e êxito da resposta

Cada resposta inclui um código de estado HTTP que indica êxito ou falha e informações adicionais de depuração. Utilize uma ferramenta de rastreio de rede para ler este código, tipo de erro e parâmetros adicionais. Para obter a lista completa, veja Códigos de erro REST do Centro de Parceiros.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 404
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 0dfadf74-aa66-49ed-9a67-b3b78d9297cc
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:07:36 GMT

{
    "id": "40cdb858-edcc-44d7-9083-d6a36d43bd3f",
    "name": "Windows 10 Enterprise E5",
    "category": "o_o_b_e",
    "description": "test policy creation from API",
    "devicesAssigned": 0,
    "policySettings": ["oobe_user_not_local_admin", "skip_express_settings"],
    "createdDate": "2017-07-25T18:07:36",
    "lastModifiedDate": "2017-07-25T18:07:36",
    "attributes": {
        "objectType": "ConfigurationPolicy"
    }
}

Partilhar via