Criar windowsOfficeClientConfigurationCreate windowsOfficeClientConfiguration

Namespace: microsoft.graphNamespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão/beta estão sujeitas a alterações; Não há suporte para o uso de produção.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Criar uma nova política de não segurança com grupos de direcionamento.Create a new non-security policy with targeting groups.

Pré-requisitosPrerequisites

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (de privilégios máximos a mínimos)Permissions (from most to least privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All

Solicitação HTTPHTTP Request

POST /officeConfiguration/clientConfigurations

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization <Token> de portador obrigatório.Bearer <token> Required.
AceitarAccept application/jsonapplication/json

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça uma representação JSON do objeto windowsOfficeClientConfiguration .In the request body, supply a JSON representation for the windowsOfficeClientConfiguration object.

A tabela a seguir mostra as propriedades que são necessárias ao criar windowsOfficeClientConfiguration.The following table shows the properties that are required when you create the windowsOfficeClientConfiguration.

PropriedadeProperty TipoType DescriçãoDescription
idid StringString ID da política de configuração de cliente do Office.Id of the office client configuration policy. Herdado de conjuntoofficeclientconfigurationInherited from officeClientConfiguration
userPreferencePayloaduserPreferencePayload StreamStream Cadeia de caracteres JSON das configurações de preferência no formato binário, esses valores podem ser substituídos pelo usuário.Preference settings JSON string in binary format, these values can be overridden by the user. Herdado de conjuntoofficeclientconfigurationInherited from officeClientConfiguration
policyPayloadpolicyPayload StreamStream Cadeia de caracteres JSON de configurações de política no formato binário, esses valores não podem ser alterados pelo usuário.Policy settings JSON string in binary format, these values cannot be changed by the user. Herdado de conjuntoofficeclientconfigurationInherited from officeClientConfiguration
descriptiondescription StringString Descrição fornecida pelo administrador da política de configuração de cliente do Office.Admin provided description of the office client configuration policy. Herdado de conjuntoofficeclientconfigurationInherited from officeClientConfiguration
displayNamedisplayName StringString Nome fornecido pelo administrador da política de configuração de cliente do Office.Admin provided name of the office client configuration policy. Herdado de conjuntoofficeclientconfigurationInherited from officeClientConfiguration
assignmentsassignments coleção officeClientConfigurationAssignmentofficeClientConfigurationAssignment collection A lista de atribuições de grupo para a política..The list of group assignments for the policy.. Herdado de conjuntoofficeclientconfigurationInherited from officeClientConfiguration
prioridadepriority Int32Int32 O valor de prioridade deve ser um valor exclusivo para cada política em um locatário e será usado para resolução de conflitos, a prioridade média de valores menores é alta.Priority value should be unique value for each policy under a tenant and will be used for conflict resolution, lower values mean priority is high. Herdado de conjuntoofficeclientconfigurationInherited from officeClientConfiguration
lastModifiedDateTimelastModifiedDateTime DateTimeDateTime Carimbo de data/hora da última modificação da política.Last modified datetime stamp of the policy. Herdado de conjuntoofficeclientconfigurationInherited from officeClientConfiguration
userCheckinSummaryuserCheckinSummary officeUserCheckinSummaryofficeUserCheckinSummary Resumo de check-in do usuário da política.User check-in summary for the policy. Herdado de conjuntoofficeclientconfigurationInherited from officeClientConfiguration
checkinStatusescheckinStatuses coleção officeClientCheckinStatusofficeClientCheckinStatus collection Lista de status de check-in do cliente do Office.List of office Client check-in status. Herdado de conjuntoofficeclientconfigurationInherited from officeClientConfiguration

RespostaResponse

Se tiver êxito, este método retornará um 201 Created código de resposta e um objeto windowsOfficeClientConfiguration no corpo da resposta.If successful, this method returns a 201 Created response code and a windowsOfficeClientConfiguration object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

POST https://graph.microsoft.com/beta/officeConfiguration/clientConfigurations
Content-type: application/json
Content-length: 1020

{
  "@odata.type": "#microsoft.graph.windowsOfficeClientConfiguration",
  "userPreferencePayload": "<Unknown Primitive Type Edm.Stream>",
  "policyPayload": "<Unknown Primitive Type Edm.Stream>",
  "description": "Description value",
  "displayName": "Display Name value",
  "priority": 8,
  "userCheckinSummary": {
    "@odata.type": "microsoft.graph.officeUserCheckinSummary",
    "succeededUserCount": 2,
    "failedUserCount": 15
  },
  "checkinStatuses": [
    {
      "@odata.type": "microsoft.graph.officeClientCheckinStatus",
      "userPrincipalName": "User Principal Name value",
      "deviceName": "Device Name value",
      "devicePlatform": "Device Platform value",
      "devicePlatformVersion": "Device Platform Version value",
      "wasSuccessful": true,
      "userId": "User Id value",
      "checkinDateTime": "2016-12-31T23:56:33.9571764-08:00",
      "errorMessage": "Error Message value",
      "appliedPolicies": [
        "Applied Policies value"
      ]
    }
  ]
}

RespostaResponse

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1069

{
  "@odata.type": "#microsoft.graph.windowsOfficeClientConfiguration",
  "id": "13a5ac73-ac73-13a5-73ac-a51373aca513",
  "userPreferencePayload": "<Unknown Primitive Type Edm.Stream>",
  "policyPayload": "<Unknown Primitive Type Edm.Stream>",
  "description": "Description value",
  "displayName": "Display Name value",
  "priority": 8,
  "userCheckinSummary": {
    "@odata.type": "microsoft.graph.officeUserCheckinSummary",
    "succeededUserCount": 2,
    "failedUserCount": 15
  },
  "checkinStatuses": [
    {
      "@odata.type": "microsoft.graph.officeClientCheckinStatus",
      "userPrincipalName": "User Principal Name value",
      "deviceName": "Device Name value",
      "devicePlatform": "Device Platform value",
      "devicePlatformVersion": "Device Platform Version value",
      "wasSuccessful": true,
      "userId": "User Id value",
      "checkinDateTime": "2016-12-31T23:56:33.9571764-08:00",
      "errorMessage": "Error Message value",
      "appliedPolicies": [
        "Applied Policies value"
      ]
    }
  ]
}