Comentários Editar

Criar deviceManagementConfigurationRedirectSettingDefinition

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

Crie um novo objeto deviceManagementConfigurationRedirectSettingDefinition .

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

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

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

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

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 String Identificador do item Herdado de deviceManagementConfigurationSettingDefinition
descrição String Descrição do item Herdado de deviceManagementConfigurationSettingDefinition
Helptext Cadeia de caracteres 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
deepLink Cadeia de caracteres Um link profundo que aponta para o local específico no console Intune do qual o suporte a recursos deve ser gerenciado.
redirectMessage Cadeia de caracteres Uma mensagem que explica que clicar no link redirecionará o usuário para uma página com suporte para gerenciar as configurações.
redirectReason Cadeia de Caracteres Indica o motivo para redirecionar o usuário para um local alternativo no console. Por exemplo: perfis WiFi não têm suporte no catálogo de configurações e devem ser criados com uma política de modelo.

Resposta

Se tiver êxito, este método 201 Created retornará um código de resposta e um objeto deviceManagementConfigurationRedirectSettingDefinition no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://graph.microsoft.com/beta/deviceManagement/reusableSettings
Content-type: application/json
Content-length: 1396

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationRedirectSettingDefinition",
  "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",
  "deepLink": "Deep Link value",
  "redirectMessage": "Redirect Message value",
  "redirectReason": "Redirect Reason 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 201 Created
Content-Type: application/json
Content-Length: 1445

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationRedirectSettingDefinition",
  "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": "3e6c3eab-3eab-3e6c-ab3e-6c3eab3e6c3e",
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value",
  "deepLink": "Deep Link value",
  "redirectMessage": "Redirect Message value",
  "redirectReason": "Redirect Reason value"
}