Пространство имен: microsoft.graph
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Создание объекта windowsPhone81CustomConfiguration.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба |
Правительство США L4 |
Правительство США L5 (DOD) |
Китай управляется 21Vianet |
✅ |
✅ |
✅ |
✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения |
Разрешения (в порядке повышения привилегий) |
Делегированные (рабочая или учебная учетная запись) |
DeviceManagementConfiguration.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) |
Не поддерживается. |
Приложение |
DeviceManagementConfiguration.ReadWrite.All |
HTTP-запрос
POST /deviceManagement/deviceConfigurations
Тело запроса
В теле запроса добавьте представление объекта windowsPhone81CustomConfiguration в формате JSON.
В приведенной ниже таблице указаны свойства, необходимые при создании объекта windowsPhone81CustomConfiguration.
Свойство |
Тип |
Описание |
id |
String |
Ключ объекта. Наследуется от объекта deviceConfiguration. |
lastModifiedDateTime |
DateTimeOffset |
Дата и время последнего изменения объекта. Наследуется от объекта deviceConfiguration. |
createdDateTime |
DateTimeOffset |
Дата и время создания объекта. Наследуется от объекта deviceConfiguration. |
description |
String |
Указанное администратором описание конфигурации устройства. Наследуется от объекта deviceConfiguration. |
displayName |
String |
Указанное администратором имя конфигурации устройства. Наследуется от объекта deviceConfiguration. |
version |
Int32 |
Версия конфигурации устройства. Наследуется от объекта deviceConfiguration. |
omaSettings |
Коллекция omaSetting |
Параметры OMA. Эта коллекция может содержать не более 1000 элементов. |
Отклик
При успешном выполнении этот метод возвращает код отклика 201 Created
и объект windowsPhone81CustomConfiguration в теле отклика.
Пример
Запрос
Ниже приведен пример запроса.
POST https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 383
{
"@odata.type": "#microsoft.graph.windowsPhone81CustomConfiguration",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"omaSettings": [
{
"@odata.type": "microsoft.graph.omaSetting",
"displayName": "Display Name value",
"description": "Description value",
"omaUri": "Oma Uri value"
}
]
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new WindowsPhone81CustomConfiguration
{
OdataType = "#microsoft.graph.windowsPhone81CustomConfiguration",
Description = "Description value",
DisplayName = "Display Name value",
Version = 7,
OmaSettings = new List<OmaSetting>
{
new OmaSetting
{
OdataType = "microsoft.graph.omaSetting",
DisplayName = "Display Name value",
Description = "Description value",
OmaUri = "Oma Uri value",
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.DeviceConfigurations.PostAsync(requestBody);
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.
mgc device-management device-configurations create --body '{\
"@odata.type": "#microsoft.graph.windowsPhone81CustomConfiguration",\
"description": "Description value",\
"displayName": "Display Name value",\
"version": 7,\
"omaSettings": [\
{\
"@odata.type": "microsoft.graph.omaSetting",\
"displayName": "Display Name value",\
"description": "Description value",\
"omaUri": "Oma Uri value"\
}\
]\
}\
'
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewDeviceConfiguration()
description := "Description value"
requestBody.SetDescription(&description)
displayName := "Display Name value"
requestBody.SetDisplayName(&displayName)
version := int32(7)
requestBody.SetVersion(&version)
omaSetting := graphmodels.NewOmaSetting()
displayName := "Display Name value"
omaSetting.SetDisplayName(&displayName)
description := "Description value"
omaSetting.SetDescription(&description)
omaUri := "Oma Uri value"
omaSetting.SetOmaUri(&omaUri)
omaSettings := []graphmodels.OmaSettingable {
omaSetting,
}
requestBody.SetOmaSettings(omaSettings)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
deviceConfigurations, err := graphClient.DeviceManagement().DeviceConfigurations().Post(context.Background(), requestBody, nil)
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
WindowsPhone81CustomConfiguration deviceConfiguration = new WindowsPhone81CustomConfiguration();
deviceConfiguration.setOdataType("#microsoft.graph.windowsPhone81CustomConfiguration");
deviceConfiguration.setDescription("Description value");
deviceConfiguration.setDisplayName("Display Name value");
deviceConfiguration.setVersion(7);
LinkedList<OmaSetting> omaSettings = new LinkedList<OmaSetting>();
OmaSetting omaSetting = new OmaSetting();
omaSetting.setOdataType("microsoft.graph.omaSetting");
omaSetting.setDisplayName("Display Name value");
omaSetting.setDescription("Description value");
omaSetting.setOmaUri("Oma Uri value");
omaSettings.add(omaSetting);
deviceConfiguration.setOmaSettings(omaSettings);
DeviceConfiguration result = graphClient.deviceManagement().deviceConfigurations().post(deviceConfiguration);
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.
const options = {
authProvider,
};
const client = Client.init(options);
const deviceConfiguration = {
'@odata.type': '#microsoft.graph.windowsPhone81CustomConfiguration',
description: 'Description value',
displayName: 'Display Name value',
version: 7,
omaSettings: [
{
'@odata.type': 'microsoft.graph.omaSetting',
displayName: 'Display Name value',
description: 'Description value',
omaUri: 'Oma Uri value'
}
]
};
await client.api('/deviceManagement/deviceConfigurations')
.post(deviceConfiguration);
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\WindowsPhone81CustomConfiguration;
use Microsoft\Graph\Generated\Models\OmaSetting;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new WindowsPhone81CustomConfiguration();
$requestBody->setOdataType('#microsoft.graph.windowsPhone81CustomConfiguration');
$requestBody->setDescription('Description value');
$requestBody->setDisplayName('Display Name value');
$requestBody->setVersion(7);
$omaSettingsOmaSetting1 = new OmaSetting();
$omaSettingsOmaSetting1->setOdataType('microsoft.graph.omaSetting');
$omaSettingsOmaSetting1->setDisplayName('Display Name value');
$omaSettingsOmaSetting1->setDescription('Description value');
$omaSettingsOmaSetting1->setOmaUri('Oma Uri value');
$omaSettingsArray []= $omaSettingsOmaSetting1;
$requestBody->setOmaSettings($omaSettingsArray);
$result = $graphServiceClient->deviceManagement()->deviceConfigurations()->post($requestBody)->wait();
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.
Import-Module Microsoft.Graph.DeviceManagement
$params = @{
"@odata.type" = "#microsoft.graph.windowsPhone81CustomConfiguration"
description = "Description value"
displayName = "Display Name value"
version = 7
omaSettings = @(
@{
"@odata.type" = "microsoft.graph.omaSetting"
displayName = "Display Name value"
description = "Description value"
omaUri = "Oma Uri value"
}
)
}
New-MgDeviceManagementDeviceConfiguration -BodyParameter $params
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.windows_phone81_custom_configuration import WindowsPhone81CustomConfiguration
from msgraph.generated.models.oma_setting import OmaSetting
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = WindowsPhone81CustomConfiguration(
odata_type = "#microsoft.graph.windowsPhone81CustomConfiguration",
description = "Description value",
display_name = "Display Name value",
version = 7,
oma_settings = [
OmaSetting(
odata_type = "microsoft.graph.omaSetting",
display_name = "Display Name value",
description = "Description value",
oma_uri = "Oma Uri value",
),
],
)
result = await graph_client.device_management.device_configurations.post(request_body)
Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.
Отклик
Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 555
{
"@odata.type": "#microsoft.graph.windowsPhone81CustomConfiguration",
"id": "0d98693c-693c-0d98-3c69-980d3c69980d",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"omaSettings": [
{
"@odata.type": "microsoft.graph.omaSetting",
"displayName": "Display Name value",
"description": "Description value",
"omaUri": "Oma Uri value"
}
]
}