Comentários Editar

Atualizar deviceManagementConfigurationSettingGroupDefinition

  • Artigo
  • 3 minutos para o fim da leitura

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 deviceManagementConfigurationSettingGroupDefinition .

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 deviceManagementConfigurationSettingGroupDefinition .

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

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

Resposta

Se tiver êxito, este método 200 OK retornará um código de resposta e um objeto deviceManagementConfigurationSettingGroupDefinition 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: 1731

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupDefinition",
  "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",
  "childIds": [
    "Child Ids value"
  ],
  "dependentOn": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationDependentOn",
      "dependentOn": "Dependent On value",
      "parentSettingId": "Parent Setting Id value"
    }
  ],
  "dependedOnBy": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingDependedOnBy",
      "dependedOnBy": "Depended On By value",
      "required": true
    }
  ]
}

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: 1780

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupDefinition",
  "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": "95dc9604-9604-95dc-0496-dc950496dc95",
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value",
  "childIds": [
    "Child Ids value"
  ],
  "dependentOn": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationDependentOn",
      "dependentOn": "Dependent On value",
      "parentSettingId": "Parent Setting Id value"
    }
  ],
  "dependedOnBy": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingDependedOnBy",
      "dependedOnBy": "Depended On By value",
      "required": true
    }
  ]
}