Atualizar deviceManagementConfigurationSettingDefinition

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para uso de produção.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Atualize as propriedades de um objeto deviceManagementConfigurationSettingDefinition .

Pré-requisitos

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	DeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

PATCH /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId}
PATCH /deviceManagement/configurationPolicyTemplates/{deviceManagementConfigurationPolicyTemplateId}/settingTemplates/{deviceManagementConfigurationSettingTemplateId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId}

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	<Token> de portador obrigatório.
Aceitar	application/json

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto deviceManagementConfigurationSettingDefinition .

A tabela a seguir mostra as propriedades que são necessárias ao criar deviceManagementConfigurationSettingDefinition.

Propriedade	Tipo	Descrição
Aplicabilidade	deviceManagementConfigurationSettingApplicability	Detalhes em qual configuração de dispositivo é aplicável
Accesstypes	deviceManagementConfigurationSettingAccessTypes	Modo de acesso de leitura/gravação da configuração. Os valores possíveis são: none, add, copy, delete, get, replace, execute.
palavras-chave	String collection	Tokens em que as configurações de pesquisa devem ser pesquisadas
infoUrls	Coleção de cadeias de caracteres	Lista de links em que mais informações sobre a configuração podem ser encontradas em
Ocorrência	deviceManagementConfigurationSettingOccurrence	Indica se a configuração é necessária ou não
Baseuri	Cadeia de caracteres	Caminho base do CSP
offsetUri	Cadeia de Caracteres	Deslocamento do caminho do CSP da Base
rootDefinitionId	Cadeia de Caracteres	Definição de configuração raiz se a configuração for uma configuração filho.
Categoryid	Cadeia de caracteres	Especifica o grupo de áreas no qual a configuração é definida em um CSP (provedor de serviços de configuração) especificado
settingUsage	deviceManagementConfigurationSettingUsage	Tipo de configuração, por exemplo, configuração e conformidade. Os valores possíveis são: none, configuration, compliance.
uxBehavior	deviceManagementConfigurationControlType	Definindo a representação de tipo de controle na experiência do usuário. Os valores possíveis são: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane.
visibility	deviceManagementConfigurationSettingVisibility	Definindo o escopo de visibilidade como UX. Os valores possíveis são: none, settingsCatalog, template.
referredSettingInformationList	Coleção deviceManagementConfigurationReferredSettingInformation	Lista de informações de configuração referenciadas.
id	Cadeia de caracteres	Identificador do item
descrição	String	Descrição do item
Helptext	Cadeia de caracteres	Texto de ajuda do item
nome	Cadeia de caracteres	Nome do item
displayName	String	Nome de exibição do item
versão	String	Versão do Item

Resposta

Se bem-sucedido, este método 200 OK retorna um código de resposta e um objeto deviceManagementConfigurationSettingDefinition atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

PATCH https://graph.microsoft.com/beta/deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}
Content-type: application/json
Content-length: 1260

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingDefinition",
  "applicability": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
    "description": "Description value",
    "platform": "android",
    "deviceMode": "kiosk",
    "technologies": "mdm"
  },
  "accessTypes": "add",
  "keywords": [
    "Keywords value"
  ],
  "infoUrls": [
    "Info Urls value"
  ],
  "occurrence": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
    "minDeviceOccurrence": 3,
    "maxDeviceOccurrence": 3
  },
  "baseUri": "Base Uri value",
  "offsetUri": "Offset Uri value",
  "rootDefinitionId": "Root Definition Id value",
  "categoryId": "Category Id value",
  "settingUsage": "configuration",
  "uxBehavior": "dropdown",
  "visibility": "settingsCatalog",
  "referredSettingInformationList": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
      "settingDefinitionId": "Setting Definition Id value"
    }
  ],
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value"
}

Resposta

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.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1309

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingDefinition",
  "applicability": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
    "description": "Description value",
    "platform": "android",
    "deviceMode": "kiosk",
    "technologies": "mdm"
  },
  "accessTypes": "add",
  "keywords": [
    "Keywords value"
  ],
  "infoUrls": [
    "Info Urls value"
  ],
  "occurrence": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
    "minDeviceOccurrence": 3,
    "maxDeviceOccurrence": 3
  },
  "baseUri": "Base Uri value",
  "offsetUri": "Offset Uri value",
  "rootDefinitionId": "Root Definition Id value",
  "categoryId": "Category Id value",
  "settingUsage": "configuration",
  "uxBehavior": "dropdown",
  "visibility": "settingsCatalog",
  "referredSettingInformationList": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
      "settingDefinitionId": "Setting Definition Id value"
    }
  ],
  "id": "7af649e5-49e5-7af6-e549-f67ae549f67a",
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value"
}