Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Importante: A Microsoft suporta Intune /beta APIs, mas estão sujeitas a alterações mais frequentes. Quando possível, a Microsoft recomenda a utilização da versão v1.0. Verifique a disponibilidade de uma API na versão v1.0 com o seletor de Versã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 deviceManagementTemplate .
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government 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. |
| Application | DeviceManagementConfiguration.ReadWrite.All |
Solicitação HTTP
POST /deviceManagement/templates
POST /deviceManagement/templates/{deviceManagementTemplateId}/migratableTo
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 do pedido, forneça uma representação JSON para o objeto deviceManagementTemplate.
A tabela seguinte mostra as propriedades necessárias quando cria o deviceManagementTemplate.
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | Cadeia de caracteres | O ID do modelo |
| displayName | Cadeia de caracteres | O nome a apresentar do modelo |
| description | Cadeia de caracteres | Descrição do modelo |
| versionInfo | Cadeia de caracteres | As informações da versão do modelo |
| isDeprecated | Booliano | O modelo foi preterido ou não. Não é possível criar intenções a partir de um modelo preterido. |
| intentCount | Int32 | Número de Intenções criadas a partir deste modelo. |
| templateType | deviceManagementTemplateType | O tipo do modelo. Os valores possíveis são: securityBaseline, , specializedDevices, advancedThreatProtectionSecurityBaseline, deviceConfigurationcustom, securityTemplate, microsoftEdgeSecurityBaseline, microsoftOffice365ProPlusSecurityBaseline, deviceCompliance, , deviceConfigurationForOffice365, , . firewallSharedSettingscloudPC |
| platformType | policyPlatformType | A plataforma do modelo. Os valores possíveis são android, androidForWork, iOS, macOS, windowsPhone81, windows81AndLater, windows10AndLater, androidWorkProfile, windows10XProfile, all. |
| templateSubtype | deviceManagementTemplateSubtype | O subtipo do modelo. Os valores possíveis são none, firewall, diskEncryption, attackSurfaceReduction, endpointDetectionReponse, accountProtection, antivirus, firewallSharedAppList, firewallSharedIpList, firewallSharedPortlist. |
| publishedDateTime | DateTimeOffset | Quando o modelo foi publicado |
Resposta
Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto deviceManagementTemplate no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
POST https://graph.microsoft.com/beta/deviceManagement/templates
Content-type: application/json
Content-length: 405
{
"@odata.type": "#microsoft.graph.deviceManagementTemplate",
"displayName": "Display Name value",
"description": "Description value",
"versionInfo": "Version Info value",
"isDeprecated": true,
"intentCount": 11,
"templateType": "specializedDevices",
"platformType": "androidForWork",
"templateSubtype": "firewall",
"publishedDateTime": "2016-12-31T23:58:16.1180489-08:00"
}
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: 454
{
"@odata.type": "#microsoft.graph.deviceManagementTemplate",
"id": "edd764ca-64ca-edd7-ca64-d7edca64d7ed",
"displayName": "Display Name value",
"description": "Description value",
"versionInfo": "Version Info value",
"isDeprecated": true,
"intentCount": 11,
"templateType": "specializedDevices",
"platformType": "androidForWork",
"templateSubtype": "firewall",
"publishedDateTime": "2016-12-31T23:58:16.1180489-08:00"
}