Criar deviceManagementConfigurationSettingGroupDefinition
Namespace: 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.
Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.
Crie um novo objeto deviceManagementConfigurationSettingGroupDefinition .
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissões
Uma das seguintes permissões é necessá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. Saiba mais sobre autenticação e autorização. |
Aceitar | application/json |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON para o objeto deviceManagementConfigurationSettingGroupDefinition.
A tabela a seguir mostra as propriedades necessárias ao criar o dispositivoManagementConfigurationSettingGroupDefinition.
Propriedade | Tipo | Descrição |
---|---|---|
Aplicabilidade | deviceManagementConfigurationSettingApplicability | Detalhes em qual configuração de dispositivo é aplicável. Dá suporte: $filters. 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 | Coleção de cadeias de caracteres | Tokens que pesquisam configurações no Herdado de deviceManagementConfigurationSettingDefinition |
infoUrls | Coleção String | Lista de links em que mais informações para a configuração podem ser encontradas. Herdado de deviceManagementConfigurationSettingDefinition |
Ocorrência | deviceManagementConfigurationSettingOccurrence | Indica se a configuração é necessária ou não Herdada de deviceManagementConfigurationSettingDefinition |
Baseuri | Cadeia de caracteres | Caminho CSP base herdado de deviceManagementConfigurationSettingDefinition |
offsetUri | Cadeia de caracteres | Deslocamento do caminho CSP da base herdada do dispositivoManagementConfigurationSettingDefinition |
rootDefinitionId | Cadeia de caracteres | ID de definição de configuração raiz se a configuração for uma configuração filho. Herdado de deviceManagementConfigurationSettingDefinition |
Categoryid | Cadeia de caracteres | Especifique a categoria na qual a configuração está em. Suporte $filters. Herdado de deviceManagementConfigurationSettingDefinition |
settingUsage | deviceManagementConfigurationSettingUsage | Indique o tipo de configuração para a configuração. Os valores possíveis são: configuração, conformidade, reusableSetting. Cada uso de configuração tem ponto de extremidade de API separado para chamar. Herdado de deviceManagementConfigurationSettingDefinition. Os valores possíveis são: none , configuration , compliance , unknownFutureValue . |
uxBehavior | deviceManagementConfigurationControlType | Configurando a representação do tipo de controle no UX. Os valores possíveis são: padrão, suspenso, smallTextBox, largeTextBox, alternância, multiheaderGrid, contextPane. Herdado de deviceManagementConfigurationSettingDefinition. Os valores possíveis são: default , dropdown , smallTextBox , largeTextBox , toggle , multiheaderGrid , contextPane , unknownFutureValue . |
visibility | deviceManagementConfigurationSettingVisibility | Definindo o escopo de visibilidade como UX. Os valores possíveis são: nenhum, configuraçõesCatalog, modelo. Herdado de deviceManagementConfigurationSettingDefinition. Os valores possíveis são: none , settingsCatalog , template , unknownFutureValue . |
referredSettingInformationList | coleção deviceManagementConfigurationReferredSettingInformation | Lista de informações de configuração mencionadas. Herdado de deviceManagementConfigurationSettingDefinition |
id | Cadeia de caracteres | Identificador do item Herdado de deviceManagementConfigurationSettingDefinition |
description | Cadeia de caracteres | Descrição da configuração. Herdado de deviceManagementConfigurationSettingDefinition |
Helptext | Cadeia de caracteres | Texto de ajuda da configuração. Dê mais detalhes da configuração. Herdado de deviceManagementConfigurationSettingDefinition |
nome | Cadeia de caracteres | Nome do item Herdado de deviceManagementConfigurationSettingDefinition |
displayName | Cadeia de caracteres | Nome da configuração. Por exemplo: Permitir torradas. Herdado de deviceManagementConfigurationSettingDefinition |
versão | Cadeia de caracteres | Versão do item herdada do dispositivoManagementConfigurationSettingDefinition |
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ção |
dependedOnBy | coleção deviceManagementConfigurationSettingDependedOnBy | Lista de configurações filho que dependem dessa configuração |
Resposta
Se for bem-sucedido, esse método retornará um 201 Created
código de resposta e um objeto deviceManagementConfigurationSettingGroupDefinition 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: 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 201 Created
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
}
]
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de